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HOW TO USE THIS MANUAL 


This second edition of the CTIX Operating System Manual, Version C, describes the 
commands, system calls, libraries, data files, and device interfaces that make up the CTIX 
Operating System for S/Series Computer Systems. This manual should always be your 
Starting point when you need to find the documentation for a CTIX feature with which 
you are unfamiliar. 


The manual consists of a large number of short entries, sometimes called ‘‘the man 
pages,’” after the command that accesses the entries when they are kept online. Each 
entry briefly documents some feature of CTIX. Some features require longer 
documentation than an entry in this manual; such features have an entry that outlines the 
feature and cross-references the manual that documents the feature fully. Entries that do 
not refer to other manuals are self-contained and are the final word on the features they 
describe. 


Organization of the manual. The entries are organized into seven sections in four 
volumes: 


Volumes 1 and 2: 
1. Commands and Application Programs. 


Volume 3: 
2. System Calls. 
3. Subroutines and Libraries. 


Volume 4: 
4. File Formats. 
5. Miscellaneous Facilities. 
6. Games. 
7. Special Files. 


Within each section, entries are alphabetical by title, except for an intro entry at the 
beginning of each section. 


Entry Title Conventions. An entry title looks like this example: 
i 
| {l 


| ea Type 
| Section Number 


Name 


Name is the name of the entry. Section Number indicates the section that contains the 
entry. In this case, the entry is in Section 3, which is in Volume 2. Entry Type appears 
only on entries that belong to special categories; refer to the section’s intro entry for an 
explanation. In this case, a reference to intro(3) would tell you that erf(3M) describes 
functions from the Math Library, which the C compiler does not load by default. 


aX 


Finding the entry you need. To find out which entry you need, refer to the following 
guides: 


@ The Permuted Index. This indexes each significant word in each entry’s 
description. It is useful when you have only a general notion what you’re 
looking for. It is also useful when you know the name of the command or 
function you are interested in, but there is no entry by that name. 


e The Table of Contents. This is a simple list of entries, by section, together with 
the entry descriptions. Volumes 1 and 2 have Tables of Contents for Section 1. 
Volume 3 has a Table of Contents for Sections 2 and 3. Volume 4 has a Table of 
Contents for Sections 4 through 7. 


e The Table of Related Entries. For Volume 1 only. A table of entries organized 
so that related entries are grouped together. 


Section organization. Each section begins with an intro entry, which provides 
important general information for that section. 


Section 1, Commands and Application Programs, describes programs intended to be 
invoked directly by the user or by command ianguage procedures, as opposed to 
subroutines, which are intended to be called by the user’s programs. Commands 
generally reside in the directory /bin (for binary programs). Some programs also reside 
in /usr/bin, to save space in /bin. These directories are searched automatically by the 
command interpreter called the shell. Commands that were not transported from UNIX 
System V reside in /usr/local/bin; this directory is recommended for locally 
implemented programs. Some administrative commands reside in /etc and various other 
places. The /etc directory is searched automatically if you are logged in as root; 
otherwise use the full path name given under SYNOPSIS or change the PATH 
environment variable to include the command’s directory. 


Section 2, System Calls, describes the entries into the CTIX kernel, including the C 
language interfaces. 


Section 3, Subroutines and Libraries, describes the available library functions or 
subroutines. Their binary versions reside in various system libraries in the directories 
Aib and /usr/lib. See intro(3) for descriptions of these libraries and the files in which 
they are stored. 


Section 4, File Formats, documents the structure of particular kinds of files; for example, 
the format of the output of the link editor is given in a.out(4). Excluded are files used by 
only one command (for example, the assembler’s intermediate files). In general, the C 
language struct declarations corresponding to these formats can be found in the 
directories /usr/include and /usr/include/sys. 


Section 5, Miscellaneous Facilities, contains descriptions of character sets, macro 
packages, and other such information. 


Section 6, Games, describes the games and educational programs that reside in the 
directory /usr/games. 


Section 7, Special Files, discusses the characteristics of files that actually refer to 
input/output devices. 


Entry organization. All entries are based on a common format, in which some parts are 


optional: 
NAME 


SYNOPSIS 


DESCRIPTION 
EXAMPLKE(S) 


FILES 
SEEALSO 
DIAGNOSTICS 


NOTES 


WARNINGS 
BUGS 


The NAME part gives the name(s) of the entry and briefly states its 
purpose. 


The SYNOPSIS part summarizes the use of the program being 
described. A few conventions are used, particularly in Section 1 
(Commands and Application Programs): 


Bold Boldface strings are literals, and are to be typed just as 
they appear. 
Regular Regular face strings usually represent substitutable 


argument prototypes and program names _ found 
elsewhere in the manual. 


{ ] Square brackets around an argument prototype indicate 
that the argument is optional. When an argument 
proitype is given as ‘‘iame’’ or ‘ ‘file,’ it always refers 
to a file name. 


Ellipses are used to show that the previous argument 
prototype can be repeated. 


~+= A final convention is used by the commands themselves. 
An argument beginning with a minus (—), plus (+), or 
equal sign (=) is often taken to be some sort of flag 
argument, even if it appears in a position where a file 
name could appear. Therefore, it is unwise to have files 
whose names begin with -, +, or =. 

The DESCRIPTION part discusses the subject at hand. 


The EXAMPLE(S) part gives example(s) of usage, where 
appropriate. 

The FILES part gives the file names that are built into the program. 
The SEE ALSO part gives pointers to related information. 


The DIAGNOSTICS part discusses the diagnostic indications that 
may be produced. Messages that are intended to be self-explanatory 
are not listed. 


The NOTES part gives information that might be helpful under the 
particular circumstance described. 


The WARNINGS part points out potential pitfalls. 


The BUGS part gives known bugs and sometimes deficiencies. 
Occasionally, the suggested fix is also described. 


A table of contents is provided at the front of each of the four volumes, along with a 
complete permuted index derived from the tables. On each index line, the title of the 


~xi< 


entry to which that line refers is followed by the appropriate section number in 
parentheses. This is important because there is considerable duplication of names 
among the sections, arising principally from commands that exist only to exercise a 
particular system call. 
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PERMUTED INDEX 


This index includes entries for all pages of Volumes 1 through 4. The entries themselves 
are based on the one-line descriptions or titles found in the NAME portion of each 
manual page; the significant words (keywords) of these descriptions are listed 
alphabetically down the center of the index. 


The index is actually a keyword-in-context (K WIC) index that has three columns. To 
use the index, read the center column to look up specific commands by name or by 
subject topics. Note that the entry may begin in the left column or wrap around and 


continue into the left column. 


A period (.) marks the end of the entry, and a slash (/) 


indicates where the entry has been continued or truncated. The right column gives the 
manual page where the command or subject is described. 


hpio: Hewlett-Packard 
/special functions of DASI 
for Interphase V/TAPE 

1310], ltol3: convert between 
comparison. diff3: 

paginator for the Tektronix 
special functions of the DASI 


long integer and base-64/ 


value. 

adb: 

abs: return integer 

/floor, ceiling, remainder, 
tiop: terminal 

t_accept: 

prevent LP requests. 

a directory for remote 

of a file. touch: update 

| utime: set file 
accessibility of a file. 
commands. graphics: 

sputl, sgetl: 

fusage: disk 

sadp: disk 

Ildfcn: common object file 
copy file systems for optimal 
locking: exclusive 

/setutent, endutent, utmpname: 
access: defermine 

enable or disable process 
acctcon2: connect-time 
acctprcl, acctprc2: process 
tumacct: shell procedures for 
faccton, acctwtmp: overview of 
accounting and miscellaneous 
diskusg: generate disk 


acct: per-process 


2645A terminal tape file/ 2... 1 6 ew ee ee ee hpio(t) 
300 and 300s ierminais. . . 2... 6 6 ee ee ee ws 3001) 
3200 half-inch tape/ Anterface . 2. 1. 1 ew ee eee ipt(7) 
3-byte integers andlongf/ . 2... 1. 7 ee ee ee ee 13tol(3C) 
3-way differential fle . . . 1... ew. ee ee wees diff3(1) 
4014 terminal. 4014: «1 ww wwe ee te 4014(1) 
450 terminal. 450: handle ..... 2... 2.6 ee eee 450(1) 
a64l, 164a: convert between . 1 ww ww we ee ee a641(3C) 
abort: generate aSIGABRT. . 2. 2... 6 eee ee abort(3C) 
abs: retum integer absolute . . 1... 1. ee ee ee abs(3C) 
absolute debugger. . . 6 ss 0s © se ee ee ee adb(1) 
ADSOIUIE:VELUE 2 &: ie SS) Ee ee we A SR GS abs(3C) 
absolute value functions, . . . 1... 1 6 1 ee eee floor(3M) 
accelerator interface. 2... 1 6 1 ee ee ew te eee tiop{7) 
accept acomnect request. . 1. 2 2 6 ee ee ewe t_accept(3n) 
accept, reject: allowor .. 2.1... 0.1 ee ee ae accept(1M) 
access. adv: advertise . 2. 1 6 es ee ee we se eee ae adv(1M) 
access and modification times . . .. 1... 2.8 2 ee touch(1) 
access and modification times. ........-4.208- utume(2) 
access: determine... 1. 1 ee ee ee we we ee access(2) 
access graphical andnumencal .........., graphics(1G) 
access long integer dataina/ .. 1... 4... ee ee sputl(3X) 
BCCeSs promler: a cs we. se: ey He i “eo Sw SS fusage(1M) 
ACCESS PIONler: <a ce eS SG ee “Pele a ew sadp(1M) 
ROCESS TOULINES) <6. 26: Ges og, ca Cer ae Se ws eK ee HS idfcn(4) 
ACCESS UNE: ACOPY sees ea ae we we Bw: dcopy(1M) 
access toregions ofafile. ....-..+6+4-04e8e0. locking(2) 
access utmp fileentry, . 2... 2. 2 ee eee ees getut(3C) 
accessibility ofafile. . 2... 2 2 2 ee ew oe ww wo access(2) 
SCCOUNLING, “ACCS alu SS ee Se eS a ee acct(2) 
accounting. acctconl, . 2... 2.6 eee wee acctcon(1M) 
ACCOUNEING.. <a iw 8) Be OR we we SE wh acctprc(1M) 
accounting. /startup, . . 2... 2... +. e ee eee acctsh(1M) 
accounting and miscellaneous/ . .......-0244.2. acct(1M) 
accounting commands. fof... ... 1.265422 acct(1M) 
accounting databyuserID. .........24... diskusg(1M) 
accounting file format. .. . 1... 6 ee eee eee acct(4) 
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search and print process 
acctmerg: merge or add total 
summary from per-process 
wimpfix: manipulate connect 
runacct: mun daily 

process accounting. 

file format. 

per-process accounting/ 
process accounting file(s). 
connect-time accounting. 
acctwimp: overview of/ 
accounting files. 

accounting. 

orderly release/ t_rcvrel: 
trig: sin, cos, tan, asin, 
killall: kill all 

sag: system 

sar: sal, sa2, sadc: system 
sar: system 

current SCCS file editing 
report process data and system 
Dialers: 

random, hopefully interesting, 


accitmerg: merge or 
putenv: change or 
Anet_netof: Internet 
getservaddr: get network 
control. arp: 


arp: 
endpoint. t_bind: bind an 
allow synchronization of the/ 
system. 

SCCS files. 

network listener service 
tfadmin: Remote File Sharing 
uadmin: 

uadmin: 

swap: swap 

remote access. 


remote access. adv: 

fumount: forced unmount of an 
alarm: set a process 

clock. 

sendmail. 

aliases: 

the data base for the mail 
t_alloc: 

change data segment space 
realloc, calloc: main memory 
mallinfo: fast main memory 
accept, reject: 

adjtume: correct the time to 
process by changing/ renice: 
sort: sort 

link editor output. 
introduction to commands and 


accounting file(s). acctcom: . .. +--+ +e ees acctcom(1) 
accounting files. . 2... 2. 6 ee ee ee ewe acctmerg(1M) 


accounting records. /command ......-. . . acctcms(1M) 
accounting records. fwimp, .... +--+. +++ ee. fwtmp(1M) 
ACCOUNUING. sie!) 6 ee ee ew ee we aw ew runacct(1M) 
acct: enable ordisable . . 2. 6 6 1 ee ee ew we ee acct(2) 
acct: per-process accounting . 2... + - 6 + + 2 eee acct(4) 
acctcms: command summary from ...... . . acctcms(1M) 
acctcom: search and print . . 2... + + +e ee eee acctcom(1) 
acctcon], acctcon2: . 2. 1... 1 6 ee th we ee acctcon(1M) 
acctdisk, acctdusg, accton, . . 2 2 2 ee ee ee ee acct(1M) 
acctmerg: merge oraddtotal ....-..-+..-. . acctmerg(1M) 
acctprcl, acctprc2: process  . 6 6 6s ee ee eee acctprc(1M) 
acknowledge receipt ofan . 2... - 6 ee ee ew t_rcvrel(3n) 
acos,atan, atan2:( 6 6 6 6 et ee eee te wt trig(3M) 
active processes. . . 2-2 6 ee ee ee ee eee killall(1M) 
activity graph, 2 6 we eee ee ee ee ee sag(iG) 
activity report package. 2... 6 ee ee eee eee sar(1M) 
activity reporter, 26. 6 we ee ee ee ee sar(1) 
activity. sact: print . 2. 6 6 2 2 es et ete we we we es sact(1) 
activity. Aime acommand; . .... + + + + + eee > tuumex(1) 
ACU/modem calling protocols. ...-- ++. ees Dialers(5) 
adage. fortune: printa . 2... 6 5 ee ee te ee fortune(6) 
adb: absolute debugger. . 2. 1. 1 2 © ee ee ee ee adb(1) 
add total accounting files. . . . 2... 2. ee ee. acctmerg(1M) 
add value toenvironment. ..... 2. eee ees putenv(3C) 
address manipulation routines. . . 2... 6 ee ee eee inet(3) 
address of service host. . . .. 2.2. + e+ eee . getservad(1M) 
address resolution display and ..-...-. +--+ ee es arp(1M) 
Address Resolution Protocol, . . . 1... -6 2. + ee eae arp(7) 
address toatransportt . 1... 1 ee ee ew ee es t_bind(3n) 
adjtime: correctthe time tO... ee eee ee ee adjtime(2) 
adman: administeraCTIX ......4....448- adman(1) 
admin: create and administer . . . . - 21-2 2 es eee admin(1) 
administration. nlsadmin: ...........-. nlsadmin(1M) 
BAUMINAStIALION,: 4 oe WE a ge ew, rfadmin(1M) 
administrative control, . 2... 6 1 ee ee we uadmin(1M) 
administrative control. . 2... 6 6 1 ee ee we ee uadmin(2) 
administrative interface. . ... 1.1. 6 2 se ee wae swap(1M) 
adv: advertise adirectory for . . . 2... 2 2 ee wee adv(1M) 
advent: explore Colossal Cave. . 2. © 2 6 ee ee es advent(6) 
advertise adirectory for . 2... 6 6 ee ee ew ee adv(1M) 
advertised resource. . . «1 6 6 ee we ee we we fumount(1M) 
Bla COCK. —15\4, ola 82 4 SF eae Se. a Sea alarm(2) 
alarm: seta processalarm  .. 1... eee ee ewe alarm(2) 
aliases: aliases flefor . . . 1... 1. 2 eee wea aliases(4) 
aliases fileforsendmail. ...... 5.56.08 500068 aliases(4) 
aliases file. rebuild ........2...24.. newaliases(1) 
allocate alibrary structure. . .. 2... ...-2.4- t_alloc(3n) 
allocation. brk, sbrk: 6 1 1 ww ee ee ee ee brk(2) 
allocator. malloc, free, . ....-. +2 + ee ees malloc(3C) 
allocator. /calloc, mallopt, . . .. 2... eee ee malloc(3X) 
allow or prevent LP requests... . 2 6. ee ee ae accept(1M) 
allow synchronization of the/ .........2.4.-. adjtime(2) 
alter priority of running . . 2... 1 eee ee ew ee renice(1) 
and/or mergé files.: 6 ako 6S cs eS sort(1) 
a.out: common assembler and ...........6+-. a.out(4) 
application programs. intro: . . 2.6 1 eee ee ee intro(1) 
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maintainer for portable/ ar: archive and library . 2... 2 1 ee ee ee te ar(1) 
format. ar: common archive file... . 2. 6 2 ee ew ew ee ar(4) 

number: convert Arabic numeralstoEnglishh . . . 2... . 21... number(6) 

language. be: arbitrary-precision arithmetic . . 2. 2... 1 6 ee eee be(1) 

for portable archives. ar: archive and hbrary maintainer . . . . - 1... ee ees ar(1) 
cpio: format of cpio archive. 2... 6 6 we ee ee et et ee cpio(4) 

ar: common archive file format... ... 2.2. 6 ee we ee ee eee ar(4) 

header of amember of an archive file. Ahe archive ..... 1.2... 2 we, idahread(3X) 
formats. convert: convert archive filestocommon ........++.2+46-6 convert(1) 
an archive/ ldahread: read the archive header ofamemberof ......4.4.4.. Idahread(3X) 
2645A terminal tape file archiver. /Hewlett-Packard ........4.+.02. hpio(1) 

tar: tape file archiver, . 2.0 5 2 6 se et eee te ew we wee tar(1) 

maintainer for portable archives. /archive and library ........+..242428- ar(1) 
cpio: copy file archivesinandout. ... 2... 2 2 ee eee eee cpio(1) 

varargs: handle variable argument list. . . . 1... 6 ee ew ee eee eee varargs(5) 
formatted output of a varargs argument list. fprint . . . 1. 1. + 2 1 ee ee ew vpnintf(3S) 
command. xargs: construct argument list(s) and execute... 1... 2 ee eee xargs(1) 
getopt: get option letter from argument vector, . 2... 6 2 ee ee eh ee ee getopt(3C) 
expr: evaluate arguments as anexpression. . ... 2. 2 ee ee eee expr(1) 

echo: Geno: ATQUINGNIS.. 6 ke SS eS ew eee eS echo(1) 

be: arbitrary-precision arithmetic language. . . 2... 1 1 1 ee ee ew ee ee be(1) 
number facts. arithmetic: provide dnilin .........66. anithmetic(6) 

dispiay and coniroi. amp: address resolution . . 2... ee ee we ee ee arp(1M) 
Protocol. arp: Address Resolution ..... 1.4.6 eee wees arp(7) 

ftp: ARPANET file transfer program. . . . . 2... 2. 2 ee ee ftp(1) 

expr: evaluate arguments aS anexpression. . 2... 1 2 ee ee ee eh ee expr(1) 
as:common assembler. . . 2... 1 1. 1 ee ee ee eee as(1) 

/attach and detach serial lines as network interfaces. . 2... 2. 1. 6 1 ee eee slattach(1M) 
Aocate a terminal to use as the virtual system console. .......-...-. conlocate(1M) 
characters. asa: interpret ASA carriage control . . 1. 1 6 ee we ee ee ee asa(L) 
and/ /gmtime, asctime, cftime, ascftime, tzset: convert date .........-+244e-6 ctime(3C) 
ascii: map of ASCII characterset. 2... 6 ee ee eee ee ee ascii(5) 

hd: hexadecimal and asciifiledump. . . 2... 66 1 ee ewe we ee ewes hd(1) 

set. ascii: mapof ASCII character . 2... 1. 1 ee ee ee ascii(S) 

long integer and base-64 ASCII string. /convert between . . . 2... 1.2. eee a641(3C) 
strings: extract the ASClIItext stringsinafilee ..........06.-. strings(1) 

ctime, localtime, gmtime, asctime, cftime, ascftime/ .... 2... 056 ew ee ctime(3C) 
trig: sin, cos, tan, asin, acos,atan, atan2:/  . 2... 1 6 ee ee ee ee tng(3M) 

output. a.out: common assembler and link editor . . . 1. 1 ew ew ee ee a.out(4) 
as:common assembler. . 2. 6 5 3 es se eh te we we we ee te tw as(1) 

assertion. assert: verify program... 1. ee ee ee et ee assert(3X) 

setbuf, setvbuf: assign buffering toastream. ... 2... 2... 2-4 setbuf(3S) 

system commands. assist: assistance using CTIX .........2+4+46-. assist(1) 

astgen: generate/modify ASSISTmenus andcommand/ .........2.4.-. astgen(1) 
commands. assist: assistance using CTIX system ..........06-. assist(1) 

print the list of blocks associated with an. bcheck: 2. 2... 2... wee bcheck(4M) 
/create device nodes for assorted device types. 1... 1... 2 0 ee eee createdev(1M) 
menus and command forms. astgen: generate/modify ASSIST .........4.. astgen(1) 
alater time. at, batch: execute commands at ........4 2 0 ees at(1) 

/sin, cos, tan, asin, acos, atan, atan2: trigonometricf . 2... 2. 2 we ee ee tng(3M) 
cos, tan, asin, acos, atan, atan2: trigonometric/ /sin, . «©... 1. 6 ee ee ew trig(3M) 
description file. queuedefs: at/batch/cronqueue . 2... 1... 2 2 ee ee eee queuedefs(4) 
double-precision/ strtod, atof: convert stringto .... 2... ee eee eee strtod(3C) 
integer. strtol, atol, atoi: convert stringto  . 2... 1 1 ew ee ee ee strtol(3C) 

integer. strtol, atol, atoi: convert stringto  .. 1... 1 1 ee ee es strtol(3C) 

as/ slattach, sldetach: attach and detach serial lines . ........26-. slattach(1M) 
resources. mmnttry: attempt tomountremote .........+e4e. mmnttry(1M) 

log of failed login attempts. Ausr/admfloginlog: .........244.-. loginlog(4) 
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wait: await completion of process... 2... 6 + + + ee ee wait(1) 

processing language. awk: pattern scanning and... 1. 6 ee ee ee es awk(1) 
ungetc: push character back into input stream. ..... +--+ e+: = . ungetc(3S) 
back: the game of backgammon. . .... +... 2 ees back(6) 

back: the game of backgammon. ... - 6 ee ee ee ee ee ee ee back(6) 

finc: fast incremental backup. . . 1... eee ee ee ee ees . finc(1M) 
ckbupscd: check file system backup schedule. . . . 2-6 - / ee ee tee ckbupscd(1M) 
frec: recover files froma backuptape. 2. 2 1. 6 ee ee ee eee ee we frec(1M) 
banner: make posters. «6. 6 ee ee te ee ee banner(1) 

newaliases: rebuild the data base forthe mail aliases/  . «7 eee ee ee newaliases(1) 
Sun rpc program number data base. rpc: 2 6 6 ee et ee ee ee ee ee ee rpc(4) 
terminal capability data base. termcap: . 2. 2 6 6 6 ee ee ee tt ee es termcap(4) 
terminal capability data base. terminfo: . . 6 6 1 6 ee eee ee ee ee terminfo(4) 
between long integer and base-64 ASCII string. /convert . 2... 1 2 + ee ee a641(3C) 
(visual) display editor based on ex. /screen-oriented . ~~... +--+ se ee eee vi(1) 

from proto file; set links based on. foutfile lists 2. 6. 6 6 1 ee eee ee ee qlist(1) 
portions of path names. basename, dimame: deliver... 2... ee ee ee basename(1) 
later time. at, batch: execute commands ata ... 1. 2 2 2 es we ee ee at(1) 

arithmetic language. be: arbitrary-precision . . - 6 6 ee ee te ee ee be(1) 

blocks associated with an. bcheck: print the listof . 2... 6... eee eee bcheck(1M) 
system initialization/ brc, bcheckrc, drvload, powerfail: . . 2... 2 ee eee bre(1M) 
string operations. bcopy, bemp, bzera: hit and byte . - - - - +--+ 2 ee ts hstrine (3) 
byte string operations. bcopy, bemp, bzero: bitand . . . . 1. eee eh eee bstnng(3) 
beopy: interactive block copy. . . 2... + ee ees bcopy(iM) 

Bdiff: big: diff... 6. oo eke SS ed GS ee Se aS bdiff(1) 

cb: C program beautifier, 2... 1 6 6 ee ee ee ee te ee we cb(1) 

about the operating system for beginning users. finformation .....-...-..-. starter(1) 
jO, 31, n, yO, yl, yn: Bessel functions. besseli 2 6. 1 ww we te ee bessel(3M) 

yn: Bessel functions. bessel: jO,jl,jn,yO,yl, . 2. 2... 6 6 ee ee ee bessel(3M) 

bfs: big file scanner. . . 2. 2 2 6 6 ee ee te ee ww bfs(1) 

cpset: install object files in binary directories. . 2... 6 6 ee ee ee ee es cpset(1M) 
fread, fwrite: binary input/outpuL . . . 2 1 ee eee ee ee fread(3S) 

bsearch: binary search asortedtable. . . ....-+-.... bsearch(3C) 

tfind, tdelete, twalk: manage binary search trees. tsearch, . . . . 2. 6 + ee ees tsearch(3C) 
bind: bind anametoasocket. . 2... 6.6. 6 ee ee eww bind(2) 

endpoint. t_bind: bind an addresstoatransportt . 2. we ee ee ee t_bind(3n) 

bind: bind aname toasocket. ... 1.2.6 +e ee eee bind(2) 

nfsd, biod: NFSdaemons. ......-.-+ +++ +e eee. nfsd(iM) 

boopy, bemp, bzero: bit and byte string/ 2. 1 we ee ee tt ee es bstring(3) 

bj: the game of black jack. «2. 2. 1 2 6 ee ee ee eee bj(6) 

Bjc the game of black jack. 4. <<: 206 @ a ce ow ee OW Se Se bj(6) 

beopy: interactive block copy. . 2... 1 ee ee ee ee ee ee bcopy(1M) 

sum: print checksum and block count ofafile. 2... 2. 6 ee ee ee tee sum(1) 
sync: update the super block. 2. 2 2 1 1 6 ee ee ee ee ee ew ee sync(1M) 
sync: update super block. . 2. 2 2 6 2 eee ee ee ee th ee sync(2) 

df: report number of free disk blocks andi-nodes. . . 2... 1 1 ee 2 te we ew ee df(1M) 
bcheck: print the list of blocks associated with am. . 2... 1 6 ee ee ee bcheck(1M) 
libdev: manipulate Volume Home Blocks (VHB). . . 1... 2 6 2 ew ee ee eee libdev(3X) 
powerfail: system/ bre, bcheckrc, drvioad, . . . 2... 6 ee ee ee es brco(1M) 

space allocation. brk, sbrk: change datasegment .......+...4.-. brk(2) 
modest-sized programs. bs: acompiler/interpreter for 2... 1... 1. ee ee ee bs(1) 
sorted table. bsearch: binary searcha ...... 2+ ee eee bsearch(3C) 

stdio: standard buffered input/output package. . . 2... - ee. ee. stdio(3S) 

setbuf, setvbuf: assign bufferingtoastream. ..... 1. ee ee ee ee setbuf(3S) 
mknod: build special file. 2... . 2... 2 2 ee eee, mknod(1M) 

vme: VME businterface. . . 1... 1 1 ee ew ee et ew te vme(7) 

between host and network byte order. /convert values . . 2 2. 1 1 ee eee byteorder(3) 
beopy, bemp, bzero: bit and byte string operations. . . . 6. 1 ee ee ee ee bstring(3) 
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$iz£: print section sizes in 
swab: swap 

Operations. bcopy, bemp, 
ce: 

cflow: generate 

cpp: the 

include/ includes: determine 
cb: 

lint: a 

cxref: generate 

ctrace: 

extract and share strings in 
ume. cprofile: setting up a 
object file. list: produce 


dc: desk 
cal: print 


cu: 
data returned by stat system 
Dialers: ACU/Anodem 
malloc, free, realloc, 
fast/ malloc, free, realloc, 
intro: introduction to system 
common shared NFS system 
request. rumount: 

to an LP line printer. lp, 
termcap: terminal 

terminfo: terminal 
description into a terminfo/ 
asa: interpret ASA 

text editor (variant of ex for 
files. 

advent: explore Colossal 


cc2sw, cc2fp: front-end to the 
create a front-end to the 

to the cc command. 
command. cclsw, cc2sw, 

cc command, cclsw, 


commentary of an SCCS delta. 
/ceil, fmod, fabs: floor, 


focaltime, gmtime, asctime, 
strings. 

delta: make a delta 

priority of running process by 
pipe: create an interprocess 
terminal’ s local RS-232 
stream. ungetc: push 
conversion/ chribl: generate 
and negn. eqnchar: special 
_toupper, setchrclass: 

user, cuserid: get 

/getchar, fgetc, getw: get 
fputchar, fputc, putw: put 


bytes of common object files. a tee ks ae ae. Wh ca size(1) 
DVIES:: so. 61 ee SR AS Be ee ee swab(3C) 
bzero: bit and byte string . 2... 2. eee eee bstring(3) 
Compiler: os ies a Bs we cc(1) 
C flowgraphy. 25.36 4 <<: cee we i Se eS ee cflow(1) 
C language preprocessor, . . 1. 2-1 eee eee ees cpp(1) 
C language preprocessor... - + ee ee ee ees includes(1) 
C program beautifier. 2... 1 - ee eee et et cb(1) 
C program checker. . 2. 6 6 ee ee te we te et ws lint(1) 
C program cross-reference. . 2. 6 6 se ee ee eee cxref(1) 
C program debugger. . 2 0 6 2 6 ee ee ee ee ctrace(1) 
C programs. xsl ww wt et te hw ttt te xstr(1) 
C shell environment atlogin ......-.. eee, cprofile(4) 
C source listing fromacommon ...... 6 ee ee ee lisi(1) 
Cal: print Calendar... sa. °5, os 206: Sm, Sa ee: a) Be ALS cal(1) 
Calculator 3s: 2: oS RE Se aS RR ee ek oe ae dc(1) 
CRIGNORT: ees 5. 18 oe eas ea, ee ae ee es we Se cal(1) 
calendar: reminder service. . . 1. 1. 2. 2 ee ee es calendar(1) 
call another UNIX system. . . 2... 2 1 1 2 ee ee ee cu(1C) 
Call Git: co ee ee tre es we A ee a BK SS stat(5) 
calling protocols. 2. 6/6 6 eee ee eee Dialers(5) 
calloc: main memory allocator, . . . . 1... 4. malloc(3C) 
calloc, mailopi, maijinfo: . 2... 6. ee ee ee malloc(3X) 
calls and errornumbers. . . . 1. 27 1 ee ee tees intro(2) 
Calle: WISSYS: (5 ee we Bee ee a a Ss ee nfssys(2) 
cance] queued remote resource... . 1... +s, rumount(1M) 
cancel: send/cancel requests . 2. 2. 1 ee we ee ee Ip(l) 
capability database. . 2... 1. ee se eee ee termcap(4) 
capability database. 2... 1. 1 1 ee ee ee ee terminfo(4) 
captoinfo: convertatermcap .......4e+.. captoinfo(1M) 
carriage control characters. . . 2. 6 2 1 ee eee eee asa(1) 
Castial USTs). C01! eae oe a MS ee HB eS wR edit(1) 
cat: concatenate andpnnt ... 1. 1 1 eee ee ews cat(1) 
COBVES. so ik We be ea a ee a A eee advent(6) 
cb: C program beautifier, 2 2 2 6 6 ee ee ee ee ee cb(1) 
Goi COMMICE.. 6 ar i ae ks ea ES A ee Pe cc(1) 
cc-command. CCISW,. «2.5. dee eae ee ew ew cclsw(1) 
cccommand. gence: .... 6 ee ee ee ees gencc(1M) 
cclsw, cc2sw, cc2fp: front-end .. 2... 1 ee ee cclsw(1) 
ec2fp: front-end tothe cc... 1 we eee eee ccisw()) 
cc2sw, cc2fp: front-end tothe .... 1... +2. wee cclsw(1) 
cd: change working directory, 2. 6 6 6 ee wee ee cd(1) 
edc: change thé delta: jc. a0: <a @: 4 Wl as a cdc(1) 
ceiling, remainder, absolute/ . . . . 1. 2 6 1s wee floor(3M) 
cflow: generate C flowgraph, .... 2... 2.2.4 eee cflow(1) 
cftime, ascftime, tzset:// . 2. 6 6 1 2 ww ee ee cuume(3C) 
cftime: language specific... 1... 1... ee eee cfume(4) 
(change) toanSCCS file. . 2... 2. 1 ee ee ee delta(1) 
changing nice. renice: alter ........++62-. renice(1) 
CHANNEL. ck. a SS a a Re SD es Sl -S S- pipe(2) 
channels. tp: controlling . 2... ee ee ee ee ee tp(7) 
character back into input... .........2.-. ungetc(3S) 
character classification and ........-..e.- chrtbl(1M) 
character definitions foreqn . 2... 1. ee we egnchar(5) 
character handling. / tolower, . . 2... ....2.068- ctype(3C) 
character login name ofthe .........44.- cuserid(3S) 
character or word fromaf «ww wn we eee ee getc(3S) 
character or word onastreaam. . . 2... ee wee putc(3S) 
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ascii: map of ASCII 

fgrep: search a file fora 
interpret ASA carriage control 
_tolower, toascii: translate 

tr: translate 

lastlogin, monacct, nulladm,/ 
directory. 

fsck, dfsck: 

schedule. ckbupscd: 
permissions file. uucheck: 
constant-width text for/ cw, 
text for nroff or/ eqn, neqn, 
lint: a C program 

gtpck: password/group file 
systems processed by fsck and/ 
formatted with the MM/ mm, 
file. sum: print 

chown, 

times: get process and 
terminate. wait: wait for 
libraries tool. 


of a file. 
group. 


for a command. 

classification and conversion/ 
backup schedule. 

monacct, nulladm,/ chargefee, 
chrtbl: generate character 
strclean: STREAMS error logger 


uucp spool directory 


cln: 

clear: 

status/ ferror, feof, 

the listener. nlsgetcall: get 
(command interpreter) with 
synchronization of the system 
alarm: set a process alarm 
cron: 


on a STREAMS driver. 
Idclose, Idaclose: 

close: 

t_close: 

fclose, fflush: 

telldir, seekdir, rewinddir, 


dis: object 

line-feeds. 

advent: explore 

comb: 

common to two sorted files. 
nice: run a 

cc2fp: front-end to the cc 


CHATaCIErSel: a:cek. ge BARS SG, SNS Be Sa ascii(5) 


character string. . .- 2 2 6 2 2 eee ee ee ees fgrep(1) 
characters. Q88°.. “src koe Se ee 2 me RE asa(1) 
characters. / toupper, . 2. - + - ee ee ee ee ees conv(3C) 
CHATACIENS: 34 5. 65 ee OR Ee owe tr(1) 
chargefee, ckpacct, dodisk, . 2. 6 6 2 6 ee ee ee acctsh(1M) 
chdir: change working . . «1 ee ee ee ee ees chdir(2) 
check and repair filesystems. ©... - +--+ 2 see fsck(iM) 
check file system backup ... 2. + ee eee ckbupscd(1M) 
check the uucp directones and  . 1... 1... +. uucheck(1M) 
checkcw: prepare 2. 6 ee ee ee ee ee es cw(1) 
checkeq: format mathematical... 2. 1 1 ee ee eee eqn(1) 
Checkehs | oa SS. ea OS Rw ew hint(1) 
checkers. pwck, 2 0. 6 2 ee ee ee ee te ee pwck(1M) 
checklist: list of fille . .. 2... 2 6 2 ee we eae checklist(4) 
checkmm: print/check documents . . . 2... 6 + ee es mm(1) 
checksum and block countofa . 2... 6 2 2 ee eee sum(1) 
chgrp: change owner or group. .... +. + + eee chown(1) 
child processtimes. . 2 6 1 6 1 ee ee ee ee times(2) 
child process to stopor . . 2... 1 ee eee ee eee wait(2) 
chkshlib: compare shared . 2... 1 1 + ee eee chkshlib(1) 
chmod: change mode. ..... 2+ + + + 2 se ess chmod(1) 
chmod: change mode of fille. . . 1... 2 2 2 2 we eee chmod(2) 
chown: change owner and group ....... 4.4... chown(2) 
chown, chgrp: change owneror ... 6 + ee ee ee chown(1) 
chroot: change root directory, . . 1-6 6 ee we eee chroot(2) 
chroot: change root directory ..... +--+... chroot(1M) 
chrtbl: generate character... 7 we ee ee ees chrtbl(1M) 
ckbupscd: check filesystem . . 2... 1 1 eee ckbupscd(1M) 
ckpacct, dodisk, lastlogin, . . 2. 2 6 ee ee ee acctsh(1M) 
classification and conversionf . . ..- + 6 ee ee chrtbl(1M) 
Cleanup program. . 2... es ee ee te et ws strclean(1M) 
clean-up. uucleanup: .......-+-++.-. . uucleanup(1M) 
clear: clear terminal screen. . . . 1 6-1 6 ee te ee clear(1) 
Clear i-iOdes, 60. i. ee a A ee me Be cln(1M) 
clear terminal screen. . 2. 2 2 2 2 6 ee ee ee to clear(1) 
clearerr, fileno: stream  . 2 1. 1 ee ee ee ee ferror(3S) 
client’s data passed through... ......-.. nisgetcall(3n) 
C-like syntax. csh:ashell . 2... 22 2 6 © eo we ee ee csh(1) 
clock. fhe time toallow .. 1... 2.6 e+ ee we eee adjtime(2) 
CIGCK. ae: Bn csc Ue Be ee He ee a ee A SE aw alarm(2) 
Clock daciions... = 4: 668 eS ee: a cron(IM) 
clock: report CPU time used. . 2... 1 2 ee wee clock(3C) 
clone: open any minor device . 2... 6 ee ee ee clone(7) 
close a common object file. . .....-+6-4.422.-: Idclose(3X) 
close a file descriptor, . 2... 2 ee eee te ees close(2) 
close atransport endpoint. . 2... ee ee ee es t_close(3n) 
close or flushastream. . . . 2 2. 1 + se ee ee ee es fclose(3S) 
closedir: directory/ /readdir, . .......... directory(3X) 
cli: cleari-node. 2. 0.0. 2 1 ee ee te ee th tw tw clri(1M) 
cmp: compare two files. . 2 1 6 6 6 2 ee ee ee ee cmp(i) 
code disassembler,. . . . 2... 2 ee ee ee ee we dis(1) 
col: filter reverse . 2... 1 ee ee ee ee ee col(1) 
Colossal Cave... <a> dog 00% 56-2 a SS ee 8 advent(6) 
combine SCCS deltas, 2... 2 ew ee eee ew ew ws comb(1) 
comm: select orrejectlines 2... ...... 2086. comm(1) 
command at low priority, 2... 6 1 6 ee ee ee nice(1) 
command. cclsw,cc2sw, . . 6. 6 6 et ee ee cclsw(1) 
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change root directory fora 
examples. usage: retrieve a 
env: set environment for 
remd: remote shell 

uux: UNIX-to-UNIX system 
/ASSIST menus and 

create a front-end to the cc 
quits. nohup: run a 

C-like syntax. csh: a shell 
getopt: parse 

getopts, getoptcvt: parse 
locate executable file for 
/shell, the standard/restricted 
retuming a stream to a remote 
and system/ tmex: time a 
uuxqt: execute remote 

retum stream to a remote 
per-process/ acctcms: 
system: issue a shell 

used by the /etc/fapeset 

test: condition evaluation 
ume: time a 

iocaie: idenufy a CTLX system 
argument list(s) and execute 
and miscellaneous accounting 
intro: introduction to 
assistance using CTIX system 
at, batch: execute 

access graphical and numerical 
install: install 

mkhosts: make node name 
multi-user/ rc2, rc3: run 
operating system. rcQ: run 
network useful with graphical 
streamio: STREAMS ioctl 
manipulate the object file 
cde: change the delta 

ar: 

editor output. 4.out: 

as: 

glossary: definitions of 
convert archive files to 
routines. Idfcn: 

conv: 

cprs: compress a 

Idopen, Idaopen: open a 

Aine number entries of a 
ldclose, ldaclose: close a 

read the file header of a 
entries of a section of a 

the optional file header of a 
/entnes of a section of a 
/section header of a 

an indexed/named section of a 
of a symbol table entry of a 
symbol table entry of a 

seek to the symbol table of a 
line number entnes in a 


command. chroot: .... 0.0.52. 6 2 ee eee chroot(1M) 
command description and usage . . . 1... 1. eee usage(1) 
command execution. . . 2... 1 ee ee ee ee env(1) 
command execution, ..... +6 2. + ee ee eee remd(1) 
command execution. ..... 2. ee ee ee ees uux(1C) 
command forms. . . 1. 1 6. 6 6 se ew we ee es astgen(1) 
command, gence: .... +. 2 ee eee ews gencc(1 M) 
command immune tohangups and 2... 2. 1 eee nohup(1) 
(command interpreter) with 2... 1... ee eee ee csh(1) 
command options. 2...) ee ee ee te ewe getopt(1) 
command options. . 2. 1 6 6 ee ee eee ee getopts(1) 
COMMANG.“pathis. sé. vs. io Serer ISTE SS Sw ere ee Se te, path(1) 
command programming language. . ..... eee eee sh(1) 
command. /routines for .... 6. ee ee ee ew rcmd(3) 
command; report process data. ww wwe ee ee timex(1) 
command requests. . 2... 2 6 6 ee ee ee ew uuxqt(1M) 
command. rexec: . 2 6. 2 ee ee ee et et ee rexec(3) 
command summary from . .... 2... 6 see» acctcms(1M) 
COMMANG... 6 e298: : BURRS ee BLD He eS system(3S) 
command.. finformation ..........4-+.. tapedrives(4) 
COMMMENG.. 0065-6: 16s Seite. at os a me ee Sa aS test(1) 
COMMING... 5-360 ee hd. Eee: AP Se a Se BR Be SES time(1) 
command using keywords. . . 1... 2. eee eeu e locate(1) 
command. xargs: construct 2. 2 1 6 we ee ee xargs({t) 
commands. /of accounting . . .. 2. 6... 2 1 ee ee acct(1M) 
commands and applicationf .........-6 5.2 ee intro(1) 
commands. assist: . 2. 1 6 6 ee we ee ew we tw ns assist(1) 
commands atalatertime. . 2... 2 1 ee ew ee ew we at(1) 
commands. graphics; . 1... + we we eee graphics(1G) 
COMMUNAL Goes he ask Sh coin aS se 2 SR. WA Rte install(1M) 
COMMMANGS... sce: 60 eH SO a ae HY LS mkhosts(1M) 
commands performed for... 2... 2 6 ew ee eee rc2(1M) 
commands performed to stopthe  . 2... 2. eee rcO(1M) 
commands, stat: statistical 2... 1 1 1 1 0 we ee stat(1G) 
COMMENDS. 6-26. 6biwkile “er Re owe Se SB streamio(7) 
comment section. mcs: ..... + «+e ee ee eee mes(1) 
commentary of anSCCSdelta. 2... 1... 2.2.2.2 0. cdc(1) 
common archive file format. . . . 2... eee ee ee ar(4) 
common assembler and link . ......+.+.-.2..446-.8 a.out(4) 
common assembler, . . 1... 1 6 1 ee ee ee eh as(1) 
common CTIX system terms andf/ .......... glossary(1) 
common formats. convert: . . 6.0.0. 0.6 +. 6 ee ee convert(1) 
common object file access .. 1... 1 ee ee eee Idfcn(4) 
common object file converter. . 2... 2. 21 ee eee conv(1) 
common object fille. . 2... 6. 2 2 ew eee wee cprs(1) 
common object file for/ 2... 1 6 eee ee es Idopen(3X) 
common object file function. . . .. 2... 1 2 eee Idlread(3X) 
common object file. ....-..+6.-6256206- Idclose(3X) 
common object file. Idfhread: . 2... ....-.4-. \dfhread(3X) 
common object file. umber ........... Idlseek(3X) 
common object file. /seekto . ......2.24.- ldohseek(3X) 
common object fle, . . - 2.2 66 we te ees Idrseek(3X) 
common object file. . 2... 2. ee ee ee ee Idshread(3X) 
common object file. /seekto . ......-2.206-. idsseek(3X) 
common object file. Ahe index . ......... ldtbindex(3X) 
common object file. indexed . .... 2... ldtbread(3X) 
common object file. ldtbseek: . . 2... 1. 2. eee Idtbseek(3X) 
common object file. linenum & Ae Ge linenum(4) 
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C source listing from a 

nm: print name list of 
relocation information for a 
scnhdr: section header for a 
line number information from a 
/retrieve symbol name for 
table format. syms: 

filehdr: file header for 

Id: link editor for 

section sizes in bytes of 

calls. nfssys: 

comm: select or reject lines 
ipcs: report inter-process 
/ftok: standard interprocess 
talkd: remote user 

socket: create an endpoint for 
/configuration file for uucp 
diff: differential file 
descriptions. infocmp: 
chkshlib: 


cmp: 
SCCS file. sccsdiff: 

diff3: 3-way differential file 
dircmp: directory 
expression. regemp, regex: 
regexp: regular expression 
regcmp: regular expression 
term: format of 

ce: C 

tic: terminfo 

yacc: yet another 
modest-sized programs. bs: a 
erf, erfc: error function and 
wait: await 

cprs: 

pack, pcat, unpack: 

table entry of a/ Idtbindex: 
cat: 

test: 

system. 

NFS file systems export 
(internet/ inetd.conf: 
communications/ Devices: 
gateways: routed 

netcf: Network 

resolv.conf: resolver 
STREAMS linker, load socket 
rtab: Remote I/O Processor 
config: 

enpstat: 

parameters. ifconfig: 

l/O Processor. riopcfg: 
system. lpadmin: 

system. uconf: 
t_rcvconnect: receive the 

to use as the virtual system/ 
fwimp, wtmpfix: manipulate 
on a socket. 


common object file. produce... ..... biol se ee XG list(1) 


common object file. . 2. 6 6 6 6 ee ee ee te ee nm(1) 
common object file. reloc: 2... 1 2 eee . . « « Teloc(4) 
common object file. . 2... +e ee ee . - . . scnhdr(4) 
common object file. fand 2... 1 6 ee ee eee ee strip(1) 
common object file symbol/ .........--. Idgetname(3X) 
common object file symbol . . . 2... 6 2 ee eee syms(4) 
common object files. . 2... 6 ee ee ee ee es filehdr(4) 
common object files. . 2... 6 ee ee ee eee es Id(1) 
common object files. fpnnt . 6 6 ee ee ee ee ee size(1) 
common shared NFS system... - - + + ee ee ee nfssys(2) 
common to two sorted files. . ......--. - . . . comm(i) 
communication facilities/ . .. 1... 2 6 6 2 ee ee ipes(1) 
communication package. . . 2. 6 ee ee ee ee stdipc(3C) 
communication server. . 2... 6 6 ee et ee ee talkd(1M) 
communication. . 6. 6 6 2 ee ee ee ee ews socket(2) 
communications lines. . . . 1... 2 6 6 ee te ee Devices(5) 
comparator, 2. 6 6 ee ee ee ee ee ee ew diff(1) 
compare or print out terminfo . . 2... 2. eee infocmp(1M) 
compare shared libraries tool, «2 2 1 1 1 ee ee chkshhb(1) 
compare two files. 2. 6 6 2 6 ee ee ee ee es cmp(1) 
compare two versions ofan... 6 ee ee ee es sccsdiff(1) 
comparison, 2. 6 6 ee ee ee ee ee ee diff3(1) 
COMPANSOM::.. 6 eee eS ee ee a ee eS dircmp(1) 
compile and execute regular . . 2 2 6 6 1 ee eee regemp(3X) 
compile and match routines. . 2. 6 6 2 1 ee te eee regexp(5) 
compile, 6. 6 ct ee he te te ee et ee regemp(1) 
compiled term file. ©. 2 6. 2 6 ee ee ee we ee term(4) 
compiler, 2. 6 2 ee eee ee ee ee ew whe ew ws cc(1) 
Compiler, 6.4. G6 eS eS eh eS Ae ee tuc(1M) 
compiler-compiler, . . 1. 6 ee ee ee ee we eee yacc(1) 
compiler/interpreter for 6 6 6 6 ee ee ee ee ee bs(1) 
complementary error function. . 2. 6 6 6 ee ee ee erf(3M) 
completion of process. 2... 6 6 ee ee ee ee ee wait(1) 
compress acommon object file. . .. 2... 2.22 ee cprs(1) 
compress and expand files. 2. 2... 2 ee ee ee eee pack(1) 
compute the index ofasymbol ........+.. Idtbindex(3X) 
concatenate and pnntfiles. . . 1... 7 6 ee ee ewe cat(1) 
condition evaluation command. . . . 2 6 2 ee ee ee test(1) 
config: configureaCTIX .........-+ 068. config(1M) 
configuration file. exports; . 2... 2 ee ee eee exports(4) 
configuration file forinetd . 2... . 2... ees inetd.conf(4) 
configuration fileforuucp .. 1... eee ee ee. Devices(5) 
configuration file, 6.00% 6064 # be ee we we es gateways(4) 
Configuration File. . . 2. 1... ee ee ew ee we ew netcf(4) 
configuration file. . 2... 2 6 2 ee ee eee ee resolver(4) 
configuration. /lidsocket: . 2... 1 1 eee ee ew slink(1) 
configuration table. . - . 1 1 1 ee ee et ee rtab(4) 
configure a CTIX system. . .....-.4.2+04.4-.- config( 1M) 
configure Ethemet processor. . . . - 2... ee es enpstart(1M) 
configure network interface . . 2. 1 2 eee ee ifconfig(1M) 
configure system forRemote .......+-+... riopcfg(1M) 
configure the LP spooling .... 2.2 ee se eae Ipadmin(1M) 
configure the operating ....- ++ +s ee 2 eee uconf(1M) 
confirmation from aconnect/ ........-6-. t_rcvconnect(3) 
conlocate: locate aterminal ........+6.-. conlocate(1M) 
connect accounting records. . . ...... + 2s. fwimp(iM) 
connect: initiate aconnection . .. 1... 6. 6 ee ae connect(2) 


eX 


t_accept: accept a conmectrequest. 2. 2 6. 1 1 ee ee ee ee t_accept(3n) 

t_listen: listen fora commect request. 2... 2... 1 1 ee ee ee ee t_listen(3n) 

the confirmation from a connect request. /recelve . ..- . 2. 1 ee ee t_rcvconnect(3) 
getpeemame: get name of connected peer, . . 2. 2-2 ee se ee eee getpeername(2) 
an out-going terminal line connection. dial: establish . . . 2... 2... 2-2 2 eo dial(3C) 
connect: initiate a connection on asockelL 2. 6 6 1 ee ee ee connect(2) 

down part of a full-duplex connection. shutdown: shut... . 2. 2... 2 eee shutdown(2) 
or expedited data sent overa connection. /receive data 2... 1. 6 eee ee et ee t_rcv(3n) 
data or expedited data overa connection. t_snd: send .....- 2. + + ee ees t_snd(3n) 
t_connect: establish a connection with anotherfi .........4.4.-. t_connect(3n) 
listen: listen for connections ona socket. . 2 1 6 1 ew ee we ee listen(2) 

acctconl, acctcon2: connect-time accounting. . . . . 1.0... + ee ee acctcon(1M) 

to use as the virtual system console. /locate aterminal ........4.-. conlocate(1M) 
the kernel debugger system console port. /change ... 1... + + ee eee dbconsole(1M) 
console: console terminal. . .. 1... 6. 6 6 1 ew we ee eee console(7/) 

for implementation-speci fic constants. /file header... 2... 2 2 ee ee eee limits(4) 
math: math functions and constants. . . 2. 6. 6 6s ee ee ee te ee ew ew math(5) 
file header for symbolic constants. unisid: . . 1 6 1 1 6 ee ee ww et unistd(4) 

cw, checkcw: prepare constant-width textfortroff 2... 6 6 we eee ee cw(i) 

mkfs: construct a file system. . 2... 2 1. ee ee eee es mkfs(1M) 

execute command. xargs: construct argument list(s) and . 2... 2. 2 2 we eee xargs(1) 
nroffftroff, tbl, and eqn constructs. deroff: remove .. . 1... 6 2 ese eee deroff(1) 
debugging on. Uutry: try to contact aremote system with . .........4644 Uutry(1M) 
Is: list contents of directory. . 2... 6 2 1 ew ee ee eee 1s(1) 

ttoc, vtoc: graphical table of contents routines. toc: dtoc, . 2. 2 6 ee ee ee ee toc(1G) 
csplit: context split, . 0. 6 2 2 6 ee ee ww ee te te ww esphit(1) 

address resolution display and control. arp: 2. 6 6 ee ee ete ee ee te te arp(1M) 
asa: interpret ASA carriage control characters. . 2... 6 2 ee eee et te ee asa(1) 
ioctl: control device. 2... 1. 6 ee ee te te et et ioctl(2) 

SCSiSSCSi. ‘CONITOL GEVICG;. 6. G2 > 8 mess ww ew ay scsi(7) 

Serial Line Internet Protocol control facility. /switchhed ......... 2.048. slipd(iM) 
fontl: file. ContNGh... 4 4-4-8 4s w ao Sa EG A Ge a ee fentl(2) 

floating point environment control. /fpsetsticky: IEEE. ........4... fpgetround(3) 
init, telinit: process control initialization. . 2... - 1 6 ee ee eee init(LM) 

icmp: Intemet Control Message Protocol. . . . 2... 1 6 ee ew ee icmp(7) 

msgctl: message control operations. . 2... 6 6 1 ee ee ee ew msgctl(2) 

semctl: semaphore control operations. . 2... 6 6 ew ee ee we semctl(2) 

shmctl: shared memory control operations. . 2... 6 1 eee ee ee ee shmctl(2) 
fentl: file control options. . 2. 6 6 6 ee ee ee ee ee fentl(5) 

tcp: Intemet Transmission Control Protocol, . 2... 6 6 6 1 ee ee th ee ee tcp(7) 
uadmin: administrative control, . 6. 6 6 6 ee ee ee te ee ee uadmin(1M) 
uadmin: administrative control, 2... 6 6 ee ee ee et ee ee we uadmin(2) 
wucp status inquiry and job control. uustat: 2 6. 6 we ee ee ee ee ee uustat(iC) 
VG! Version: CONITOL.: <6. 6298 Ni Ko Se ee eR Se ea a vc(1) 

V/TAPE 3200 half-inch tape controller. fforInterphase 2... 2. 2... ee ee ee ipt(7) 
set drive parameters fortape controllers. tapeset: 2... 2 2 1 ee ee ee ws tapeset(1M) 
interface. tty: controlling terminal . ... . . 16 6 eee ee ens tty(7) 

RS-232 channels. tp: controlling terminal’slocal . . . 2... 1.2.27 2 ee ee tp(7) 
converter. conv: common object fle ..........558080-.4 conv(1) 

_toupper, _tolower, toascii:/ conv: toupper,tolower, .. . . 6. 1 6 ee ee eee conv(3C) 
terminals. term: conventional names for... . 1... 6 ee ee te ee term(5) 

units: conversion program. . . . 6. 1 6 2 ewe ee ww units(1) 

character classification and conversion tables. /generate ......-..4+2-4 chrtbl(1M) 
into a terminfo/ captoinfo: convert atermcap description .......4... captoinfo(1M) 
dd: convert and copyafile. . 2... 2 es ee eee eee dd(1M) 

English. number: convert Arabic numeralsto . 2... ......0048- number(6) 

common formats. convert: convert archive filesto . 2... 6 6 ee ee te ene convert(1) 
integers and/ 13tol, Itol3: convert between 3-byte 2... 1... ee eee eee 13tol(3C) 


- XXi - 


and base-64 ASCII/ a641, 164a: 
to common formats. 

/cftime, ascftime, tzset: 

to string. ecvt, fevt, gcvt: 
scanf, fscanf, sscanf: 

strtod, atof: 

strtol, atol, atoi: 

htonl, htons, ntohl, ntohs: 
conv: common object file 
timod: Transport Interface 
dd: convert and 

beopy: interactive block 
cpio: 

access time. dcopy: 

cp, In, mv: 

volcopy: make literal 

rcp: remote file 

uuname: UNIX-to-UNIX system 
UNIX-to-UNIX system file 
core: format of 
synchronization of/ adjtime: 
atan2:/ trig: sin, 

functions. sinh, 

sum: print checksum and block 
we: word 

move files. 

cpio: format of 

and out. 

preprocessor. 

environment at login time. 
file. 

binary directories. 

clock: report 

craps: the game of 


rewrite an existing one. 
command. gencc: 

file. tmpnam, tempnam: 
an existing one. creat: 
fork: 

mk shlib: 

clags: 

tmpfile: 
communication. socket: 
channel. pipe: 

files. admin: 

assorted device/ createdev: 
umask: set and get file 


crontab: user 
cxref: generate C program 
pg: file perusal filter for 


encryption functions. 
generate hashing encryption. 
interpreter) with C-hike/ 


terminal. 


convert between long integer . 2. 2 2-6 ee ee ee a641(3C) 
convert: convert archive files ......-.-. . » . » convert(l) 
convert date andtime to/ .......-.-. we « » Cume(3C) 
convert floating-point number... 2. 2 - ee ee ecvt(3C) 
convert formatted input. 2 6 6 6 ee ee ee ee scanf(3S) 
convert string tof... ee ee eee ee te strtod(3C) 
convert string to integer, . . 2 6 2 + ee ee ee strtol(3C) 
convert values between host/ ......++-+e-s byteorder(3) 
CONVETIER,. 6. 6. i Ss Se eS ER conv(1) 
cooperating STREAMS module. . ~~... -.-+-e. timod(7) 
CODY @ TEs. Seis 8 a ee eH Be Ge ws dd(1M) 
COIS ee eee Ga BAER. ae Bs SHE: hw bcopy(1M) 
copy file archives in andout. «1... 6 + eee eee cpio(1) 
copy file systems foroptimal . . . . 1... +. 2 +e» dcopy(1M) 
copy, link, ormove files. 2... 6 6 ee ee ee eens cp(1) 
copy of filesystem. . 2... 6 ee ee eh ee ee volcopy(1M) 
COPY soe ha ay eal, to OS, Ge Bre Se SS rcp(1) 
copy. uucp,uulog, . 2 6 6 6 eee ee ee eee uucp(1C) 
copy. uuto, uupick: public . 2... 6. 1 ee ee ee uuto(1C) 
coreimage file. 2... 2 2 se eee wwe eee ee» core(4) 
correct the time toallow ......-. 46-2 6+ ws eee adjtime(2) 
cos tan asin, acns alan, . - - - - - - +--+ - + + - - tig({iM) 
cosh, tanh: hyperbolic . . 1... 2 6 ee ee eee sinh(3M) 
Count of 8:Gile:..<. is G6 ew. ee See a GLO OAS sum(1) 
COOMG.. 6. i eS ee A as el SS: Se a HR EE ee ee we(1) 
cp, In, mv: copy, link,or «6. 6 ee ee ee et ee cp(1) 
COO AFCHIVE:. <i. 6\6. on Ss BS Ew we SS cpio0(4) 
cpio: copy file archives in . . . 2 2 6 ee ee ee eee cpio(1) 
cpp: the Clanguage  .. . - 1 ee ee ee ee ee cpp(1) 
cprofile: setting upaC shell . ......- 2. ees cprofile(4) 
cprs: compress acommon object... 1 ee ee ee ee cprs(1) 
cpset: install object filesin . . 2... 2. ee ee eee cpset(1M) 
CPU time Used) “20% 4 BG SOs. HH RE aS clock(3C) 
CHADSe 5 5 ike ae et ae, Me, Re: ee ee wt Se craps(6) 
crash: examine system images. ... 2... + + eee crash(1M) 
creat: createanew fileor .........24-4-5e8e4e8- creat(2) 
create afront-endtothecc . . 1. 1 wee ee ee gencc(1M) 
create aname foratemporary ......+..4.4.. tmpnam(3S) 
create anew file orrewrite .. 1... 1 ee ee ew eee creat(2) 
create anew process. . 2. 1 6 2 ee ee ee ee ee fork(2) 
create ashared library. . 2. 2... 2. ee ee eee mkshlib(1) 
create atags file. . 6 1. 1 se ee ewe ee ee we ctags(1) 
create atemporary file. . 2... 2. 1 eee eee tmpfile(3S) 
create anendpoint for. 6 6 ee we eee th te socket(2) 
create aninterprocess «6 / - ee ee ee te et pipe(2) 
create and administer SCCS ... 1... 6 6 ee eee admin(1) 
create device nodes for . 2. 1. 6 1 6 ew ee ee createdev(1M) 
creation mask: 6-44.66. 3. 6 eo Soe a BOS Se Ree umask(2) 
cron? clock. daemon: 6-6 60.8 ‘6. se.de BOR. cae We cron(1M) 
crontab file. 4.05. <i: Sa wr wh Oe, & SS RB we crontab({1) 
cross-reference. . 2. 2 2 0 ss se eee ew eevee cxref(1) 
CRT Gea she a a Ge ee Be ee ae a es A a ee pg(l) 
crypt: Encodé/decodé.« 6 wi 6 ee Gow BR we Se crypt(1) 
crypt: password andfile .........2.+4.2424.-. crypt(3X) 
crypt, setkey, encrypt: 2... 6 1 1 ee eee ew ee crypt3C) 
csh: ashell (command... . 1.6 6 2 ee ew we eee csh(1) 
csplit: context split, ©... 2 6 ee ee ee ee ee csplit(1) 
ct: spawn getty toaremote . 2... 6 6 wee ee ee ct(1C) 
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for terminal. 
asctime, cftime, ascftmme,/ 


adman: administer a 
config: configure a 

uname: get name of current 
/definitions of common 


ttt, 

uname: get name of 
endpoint. t_look: look at the 
get/set unique identifier of 
sethostname: get/set name of 
set or print identifier of 
uname: print name of 
activity. sact: print 
t_getstate: get the 

the Intemet host name of the 
slot in the utmp file of the 
getcwd: get path-name of 
scr_dump: format of 
handling and optimization/ 
spline: interpolate smooth 
name of the user. 

each line of a file. cut: 
constant-width text for/ 
cross-reference. 

cron: clock 

rfudaemon: Remote File Sharing 
routed: network routing 
strerr: STREAMS error logger 
nfsd, biod: NFS 

runacct: ran 

Protocol server. ftpd: 
number mapper. portmap: 
telnetd: 

tftp: user interface to the 
Protocol server. tftpd: 
fhandle special functions of 
special functions of the 
fume a command, report process 
file. newaliases: rebuild the 
rpc: Sun rpc program number 
termcap: terminal capability 
terminfo: terminal capability 
generate disk accounting 
t_rcvuderr: receive a unit 
/sgetl: access long integer 
plock: lock process, text, or 
connection. t_snd: send 
over a/ t_rcv: receive 
nisgetcall: get client’s 

prof: display profile 

call. stat: 

I/O Processor for online 

brk, sbrk: change 


clags: create atagsfile, . 2... 1 2 se ee ew ee ctags(1) 
ctermid: generate fle name .......-+.-2.26-. ctermid(3S) 
cume, localume, gmtime, . . 2... 6 2 1 ee ee cume(3C) 
ctinstall: install software. . ... 2... 2 ee ee cunstall(1) 
CTIX SYSIEQ.. O56. oa BS. HS Rw LS Wie ee ele adman(1) 
CTTR ay Stems: 606 Jol ee, we Stes He, te Wee eae config(1M) 
COUN SY Stet. ei. é sei sete ue, oe a ie me et et uname(2) 
CTIX system terms and/ ........2.-.642.6. glossary(1) 
ctrace: C program debugger. . . . - 2 se ee ee es ctrace(1) 
cu: call another UNIX system. . . 2... 6 1 ewe eee cu(1C) 
CUIIC? TIC-TAC106.. 6: 6° ks cena. Ge: a me ee WS ttt(6) 
current CTIX system. . . 2. 2. 2 6 0 we ee te ewe uname(2) 
current event on atransportt . . ... 2... 2 ee ee t_look(3n) 
current host. /sethostid: . . 2... 2 ee eee gethostid(2) 
current host. gethostname, .........4.. gethostname(2) 
current host system. hostid: 2... 2. ....5. 0584 hostad(1) 
current CTIX system. 2. 6 6 6 wee th we te we we we uname(1) 
current SCCS file editing ...... 2.262560 8088-7 saci(1) 
CUIFEN STALE Ge. ee ge ww, A: ow Oe t_getstate(3) 
current system. /setorprint . .. .. 2... ee ee hostname(1) 
current user. /findthe . 2... 6 6 0 ee ee ee ttyslot(3C) 
current working directory. . . 1... 6 6 ee ee we getcwd(3C) 
curses screen image file. . . 2... 2 2 eee eee scr_dump(4) 
curses: terminal screen. 1 1 ew ew ew ee et ew curses(3X) 
CUIVE... Seb a Sieh eee SE Se a 2 spline(1G) 
cuserid: get characterlogin .......+-.22e-, cuserid(3S) 
cut out selected fields of . . . 2... 2 2 eee ee eee cut(1) 
cw, checkcw: prepare 2. 6 2 6 te wt tt ee we cw(1) 
cxref: generate Cprogram ..... 2-6 + ee eee cxref(1) 
CSGENON: oe 96. is ae. BOE a a cron(1M) 
daemon process. . 2. 2 6. 5 0 6 se oe we we tfudaemon(1M) 
GSCMION. «26 ae we, Se ar Te, a eo we routed(1M) 
QMMNONS 6 Sorts a oa aw ee BU ae Se SR eS strerr(1M) 
daemons... ..... Sis tare Mh vik es An gdn Jee Wirz. aera we nfsd(1M) 
daily QCCOURLING.: -8.ci- Se RS eo Qa ee i ee ee runacct(1M) 
DARPA Intemet File Transfer  . . . 2... 1. ee eae ftpd(1M) 
DARPA porttoRPC program . 6... 7. ee ee portmap(1M) 
DARPA TELNET protocol server. . 2... 2... telnetd(1M) 
DARPA TET? pretocon... i656, an ee SO ew tftp(1) 
DARPA Trivial File Transfer... .......2.4-, tftpd(1M) 
DASI 300 and 300s terminals. . . 1... 1 1 2 ee eee 30Q(1) 
DASI 450 terminal. fhandle . ... 1... +2. 6 eee 450(1) 
data and system activity. . 2... 1... 1 1 eee eas timex(1) 
data base forthe mail aliases ........44.. newaliases(1) 
Gate Dass, 5 5e) os ee Se ew Se EO Wo rpc(4) 
data .GASO.: <6. <6 62%, eee Be ROU. RS we BS termcap(4) 
Gate DASE. 25: aes a a BE ee a terminfo(4) 
data by user JD. diskusg: . . 2... - 2.2... 2G diskusg(1M) 
data errorindication. ... 1... 46 ee ee eee t_rcvuderr(3) 
data ina machine-independenf/ «2. 2. we wee spudl(3X) 
Gata in MeMOry., 6 4. wk, Bw we ee ee ww Ee plock(2) 
data orexpedited dataovera . .- 2. 2... ee ee t_snd(3n) 
data orexpedited datasent .........02.04- t_rcv(3n) 
data passed through the/ . . 2. 2 6 2 6 ww wee nisgetcall(3n) 
AEM i <oes6t tae “ie ah as tas SO, Bs Rees ah eae a Mee ar at > prof(1) 
data retumed by stat system .. 2... 0.2.02 ee eee stat(5) 
data. riopqry: query Remote .........4.4. nopqry(1M) 
data segment space allocation. ..........206.4 brk(2) 
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ET 


/receive data or expedited 
types: primitive system 
t_rcvudata: receive a 
t_sndudata: send a 

changes to the Help Facility 
join: relational 

using the mkfs(1) proto file 
delete, firstkey, nextkey: 
/dbm_error, dbm_clearerr: 
a terminal or query terminfo 
udp: Intemet User 
settimeofday: get/set 
/ascftime, tzset: convert 
date: print and set the 


debugger system console port. 
/dbm_nextkey, dbm_error, 
dbm_store,/ dbm_open, 
/dbm_fetch, dbm_store, 
/dbm_firstkey, dbm_nextkey, 
dbm_open, dbm_close, 

/dbm store, dbm_delete, 
firstkey, nextkey: database/ 
/dbm_delete, dbm_firstkey, 
dbm_fetch, dbm_store,/ 
/dbm_close, dbm_fetch, 


optimal access time. 


adb: absolute 

ctrace: C program 

fsdb: file system 

load symbols in kernel 

sdb: symbolic 

dbconsole: change the kernel 
contact a remote system with 
timezone: set 

sysdef: output system 
eqnchar: special character 
system terms and/ glossary: 
dbminit, fetch, store, 

names. basename, dimame: 
file. tail: 

delta commentary of an SCCS 
file. delta: make a 

delta. cdc: change the 
rmdel: remove a 

to an SCCS file. 

comb: combine SCCS 
errdemon: error-logging 
terminate the error-logging 
mesg: permit or 

tbl, and eqn constructs. 
usage: retrieve a command 
description into a terminfo 
queuedefs: at/batch/cron queue 
system: system 

captoinfo: convert a termcap 


data sent overaconnection. ......+..-. . . - + tyrev(3n) 


data types. © 6 0 ee ee ee ee ee ee types(5) 
dataunit. .....- ervaG epee, Bene weiss ek t_rcvudata(3) 
data unit:: 4-3-6 a ew a SE Oe a es t_sndudata(3) 
database. helpadm: make ......+-+-+ +. helpadm(iM) 
database operator, 2... 2 2-2 ee tt ee tt ee join(1) 
database. /and verify software... . -. +2 ese qinstall(1) 
database subroutines. /store, . . . 2. 6 2 ee ee ee dbm(3X) 
database subroutines. . . 2. 1. 2 ee ee ew ee es ndbm(3X) 
database. tput: initialize 6. 6 ww ee ee ee ee ee tput(1) 
Datagram Protocol, . 2. 6 6 6 6 ee ee ee we ee udp(7) 
date and time. gettimeofday, ......... . gettimeofday(2) 
date and time tostring. . ... - + 2 ee ee eee ctime(3C) 
GRey. ak Boe A, te. SS a Se BS ee OES date(1) 
date: print and setthe date. 2. 2... 6 ee ee ee eee date(1) 
dbconsole: change the kernel . . . . 1.2.22. . dbconsole(1M) 
dbm_clearerr: database/ . 2. 2 ee ee ee ee ee ndbm(3X) 
dbm_close, dbm_fetch, ....-- +++ ee eee ndbm(3X) 
dbm_delete, dbm_firstkey/ . 2... 1... 2. ess ndbm(3X) 
dbm_error, dbm_clearerr:/  . 2. 6 1 ee ee ew ee ndbm(3X) 
dbm_fetch, dbm_storej . 6 we ee ee ee ees ndbm(3X) 
dhm_firstkey, dbm_nextkey/ 2... 2... - 2... . ndbmGX) 
dbminit, fetch, store,delete, . . 2... 2.2. ee 2 wee dbm(3X) 
dbm_nextkey, dbm_errorjf 2... 1 6 2 2 ee ee es ndbm(3X) 
dbm_open, dbm_close, . . 2. 6-2 + 2 ee ee eee ndbm(3X) 
dbm_store, dbm_delete/ . 2... 2 2 2 eee eee ndbm(3X) 
dc: desk calculator, 2... 1 6 1 et ee ew ew we te dc(1) 
dcopy: copy file systems for .. 2... 2.6 se eae dcopy(1M) 
dd: convert and copyafile. . 2... - 2 eee ee eee dd(1M) 
debugger. «2 2 6 ec ee hh twee ew we we adb(1) 
GeDWeseh. a9 k eee) a eH 8: Eee Sd me ctrace(1) 
debugger, . 2. 2 2 ee severe ere en sevens fsdb(1M) 
debugger. mkdbsym: .... +--+ ee ee ee mkdbsym(1M) 
GODUR RET: - 66. a es Wi aw oH a He ek, eS, sdb(1) 
debugger system console pont. . . . .. 2... . dbconsole(1M) 
debugging on. Uutry:tryto «wwe ee ee ee Uutry(1M) 
default system time zone. . 2 2 6 ee ee ee es timezone(4) 
Gefinition.: 6) 60 46S Swe he Bee ee sysdef(1M) 
definitions foreqn andneqn. ... 2... ee eee eqnchar(5) 
definitions of common CTIX .......2.2 2.60488 glossary(1) 
delete, firstkey, nextkey:/ . .. --:.-:: 2+ + +» dbm(X) 
deliver portions of path . 2. 1 1 ee ee ee es basename(1) 
deliver the last partofa . . 1... ee eee we ee ne tail(1) 
delta. cdc: change the . 2 2 2 1 6 ee wwe we te we ww cdc(1) 
delta (change) toanSCCS ..... 2.56 2. ee eee delta(1) 
delta commentary ofanSCCS .........+46-. cdc(1) 
delta from an SCCS file. 2. 2... 2 2 ee ee ee ee rmdel(1) 
delta: make adelta (change) . . ~~... 1 + ee eee delta(1) 
WEMASs> a: SS er BR ee ee as Se comb(1) 
GEWIONs: | ho Gack Ge. a ek WO He. Whe vee ks ee errdemon(1M) 
GEMON: SMNSIOPe ka: eh ae ae wa ee a errstop(1M) 
Genny MESSAGES: oi) ee BIS See ee Res a mesg(1) 
deroff: remove nrofftroff, . ..... 256+ +6 eee. deroff(1) 
description and usage/ . . 2. 6 ee ee ee ew ee usage(1) 
description. /atermcap .. 1... - - ee ee ee captoinfo(1M) 
descnption file... 36.606 66.4 SW we oe SS queuedefs(4) 
description file: s,s. 6 6804 Mw we eee es system(4) 
description into aterminfo/ ........... captoinfo(1M) 
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compare or print out terminfo 
close: close a file 

dup: duplicate an open file 
dup2: duplicate an open file 
getdtablesize: get 

de: 

slattach, sldetach: attach and 
file. access: 

preprocessor/ includes: 
identifier. fstyp: 

file: 

drivers: loadable 

lines for finite width output 
master: master 

ioctl: control 

devnm: 

device/ createdev: create 
clone: open any minor 
hekset, td: graphical 

scsi: scsi control 

device nodes for assorted 
for uucp communications/ 
scsimap: set mappings for SCSI 


blocks and i-nodes. 
systems. fsck, 

terminal line connection. 
ratfor: rational FORTRAN 
protocols. 

bdiff: big 

comparison. 

sdiff: side-by-side 
diffmk: mark 

diff: 

diff3: 3-way 


file. uucheck: check the uucp 
install object files in binary 
dir: format of 

link and unlink files and 
mkdir, mkdirs: make 

mm, rmdir: remove files or 
cd: change working 

chdir: change working 
chroot: change root 
uucleanup: uucp spool 
dircmp: 

file. getdents: read 

file system independent 
unlink: remove 

chroot: change root 

/make a lost+found 

adv: advertise a 

path-name of current working 
Is: list contents of 

mkdir: make a 

mvdir: move a 


descriptions. infocmp: .... 2-62. + eee infocmp(1M) 
GOICTIONOE: ~S< kee We we Saw Se RO Sa a Gs close(2) 
GESCINOR.. 364. We She See ta ee we Se we dup(2) 
GESCINOT:. es :ar3s ee we RR Ee es dup2(3C) 
descriptor table size. 2. 2 1 ee ee ee es getdtablesize(2) 
desk calculator. 6.6. 4.606). a Ss Sw SE Sees dc(i) 
detach serial lines asmetwork/ . . . . .- - 2 se es slattach(1M) 
determine accessibility ofa . 2... 1. 2 ee ee eee access(2) 
determine Clanguage . . 2... 2 ee ee ee wee includes(1) 
determine file system .. 2... 2. ee ee ee ees fstyp(1M) 
determine filetype. . 2 2. 6 ee ee ee ee te ee file(i) 
device drivers. . 2... se eee we seen wee ves dnvers(7) 
device. fold:foldlong . . 1... - 6. 6 ee eee eee fold(1) 
device information table. . . 2... 6 2 ee eee ee master(4) 
GOVICE) Bo See Be AS OR we Se er SBS ioctl(2) 
device name. . 1. 61 ee eee ee tw tee we devnm(1M) 
device nodes for assorted . . 2... ee ee ee createdev(iM) 
device ona STREAMS driver, . 2.2. - 2 2 se we vee clone(7) 
device routines and filters. . 2. 2 6 1 1 ee ee ee gdev(1G) 
GEVICES 8 ov ea OW RE A ORE Ae eS scsi(7) 
device types. fcreate 2 6 6 1 ee ee ee ee createdev(1M) 
Devices: configuration fle .. . 1... 1. eee eee Devices(5) 
GEVICES.. 6a 4c be ERA EM a scsimap(1M) 
devnm: device name. . 2... 6 6 ee ee te ee devnm(1M) 
df: report number of freedisk «2 6 1 6 ee ee eee df(1M) 
dfsck: check and repairfile ... 2... 2. 2. e. eee fsck(1M) 
dial: establish an out-going . . 2... + es se we ee dial(3C) 
Gimlect:.. <--S-\e- ee at ee ee oO we Ge ratfor(1) 
Dialers: ACU/modem calling .... 2... - ee ee Dialers(5) 
GUT. seas ae ve, 24 a eR we B®, Ses BS ee RY eS bdiff(1) 
diff3: 3-way differential fle ... 2... . ee ee eee diff3(1) 
difference program. 6 6 6 6 2 ee ee ee ee ee sdiff(1) 
differences between files. . . 2. 6 0 eee we eee diffmk(1) 
differential file comparator. . 2 26 6 2 ee ee ee diff(1) 
differential file comparison. . . . . 2-6 ee ee ees diff3(1) 
dir: format of directories. . 2... 1 1 6 ee ee ee ee dir(4) 
dircmp: directory comparison. . . - 2... + ee ees dircmp(i) 
directories and permissions . . . . 1... +s eee uucheck(1M) 
directories. cpset: 2 6 6 6 ee et ee ee ee es cpset(1M) 
GITECLOTIES = Sei Se ne eee Se Sw ces, HB SS dir(4) 
directories. link, unlink: . . . 2... 1 ee ee eee link(1M) 
GITECIONIOS:. 6046-5 68S Ge ws OR OE OS mkdir(1) 
GITECIONESS 55s We. Se ee ee te SE ae rm(1) 
GUE ok. Sa EE EE Oe SS SS cd(1) 
GIECIONY, eas. ASS a ee: Ss ic Le eS chdir(2) 
GITECIORY: 86.6 eG A we SE Ee a BE chroot(2) 
directory cleanup. ... 1... 2 ee ee eee uucleanup(1M) 
directory comparison. . . 2. 2 6 eee ee ee ee dircmp(1) 
directory entnes and putina .........e..-s getdents(2) 
directory entry. dirent: 2... 6 1 ee ee ee ee ee dirent(4) 
GINECIOTY EMATY. ogo. a) A BE Se Ow Rte SE unlink(2) 
directory foracommand. ......- 2.4286 chroot(1M) 
directory forfsck. . 2... 6 6 we ee we eee mklostfnd(1M) 
directory for remote access. «2. 6 1 ee ee et es adv(1M) 
directory. getcwd: get 2. 2 1 ee eee ee getcwd(3C) 
GCC ck 50h 8 Ge WS Ee Gs Re OPS Is(1) 
GUCAMY: 8 iG ene a owl aw Se ee mkdir(2) 
GUE CUONY... Gs eGo. A, Ee he se Bh a eS Se mvdir({iM) 
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Sines re ee 


pwd: working 

/seekdir, rewinddir, closedir: 
ordinary file. mknod: make a 
rmdir: remove a 

independent directory entry. 
path names. basename, 


t_unbind: 

printers. enable, 

acct: enable or 

dis: object code 

type, modes, speed, and line 
type, modes, speed, and line 
t_snddis: send user-initiated 
retrieve information from 
fusage: 

sadp: 

ID. diskusg: generate 

df: report number of free 
disk: general 

update: provide 

du: summarize 

accounting data by user ID. 
arp: address resolution 

v1: screen-oriented (visual) 
information. rmnitstat: 

prof: 

statistics. serstat: 

local network. ruptime: 
hypot: Euclidean 

/icong48: generate uniformly 
Sharing domain and network/ 
routines. /res_send, res_init, 
/res_send, res_init, dn_comp, 
MM/ mm, checkmm: print/check 
macro package for formatting 
slides. mmt, mvt: typeset 
nulladm,/ chargefee, ckpacct, 
whodo: who is 

print Remote File Sharing 
named: Internet 

/atof: convert string to 

gtdl, ptdl: RS-232 terminal 
nrand48, mrand48, jrand48 / 
graph: 

arithmetic: provide 
controllers. tapeset: set 

used by the/ tapedrives: tape 
facilitate usage of a tape 

any minor device on a STREAMS 
disk: general disk 

Iddrv: manage loadable 
drivers. 

initialization/ bre, bcheckre, 
table of contents/ toc: 


and status information from 
hd: hexadecimal and ascii file 


directory name... coe v8 Pe we ee pwd(1) 
directory operations. 2... 6. ee ee ee eee directory(3X) 
directory,oraspecialor . . 2... 1. eee eee mknod(2) 
GIF ECUONY <° 02 Go: Nisirsa: We Br ee OS eee ee Ae Sm rmdir(2) 
dirent: filesystem . 2... 1 2 ee ee ee ew ww we dirent(4) 
dimame: deliver portions of... 1... - 2 ees basename(1) 
dis: object code disassembler. . 2. 2 2. 2 2 ee eee ees dis(1) 
disable atransport endpoint. ........ . t_unbind(3n) 
disable: enable/disable LP . . . ......-..4--. enable(1) 
disable process accounting. ....- +--+ eee eee acct(2) 
GisassemDleh:, — 6.8 6 ek RS Oe ee me eS dis(1) 
discipline. /setterminal . 2... 2 1 ee te ees getty(1M) 
discipline. /setterminal . . 2... eee ee eee uugetty(1M) 
disconnect request. «2 6 1 2 ee ee ee ew ee t_snddis(3n) 
disconnect. t_rcvdis: . . 2... 6 1 ee ee we ww t_rcvdis(3n) 
disk access profiler, .......--6+20 eee fusage(1M) 
disk access profiler, . . 2... 1 2 ee eee ee ee sadp(1M) 
disk accounting databy user .......-.+6-. diskusg(1M) 
disk blocks and i-nodes. . 2. 1. 1. 1 2 ee ee ee ee df(1M) 
GIG GTIVERS <6 ok eo 28 we a. ES a a disk(7) 
disk synchronization. ©... 1 6 ee ee ee ew ee update(1M) 
Gisk Wises 6. whe ee oe OS a ee Be du(1M) 
diskusg: generate disk . . 2. 6 6 ee ee ee we diskusg(1M) 
display and control. . 2. 2. 6 ee ee ee ew te ee arp(1M) 
display editor based onex. . 2... - 2 ee eee ew eee vi(1) 
display mounted resource... 1... 1 eee eee rmntstat(1M) 
display profile data. 2... 2 1 ee ww ee we ee es prof(1) 
display serial porterror . 2... 1 1 ee ee ee serstat(]M) 
display status ofnodeson ......- ee e+ eee ruptime(1) 
distance function, ..... 2+ ee ee ee eae hypot(3M) 
distributed pseudo-random/ ........-..44.-. drand48(3C) 
dname: print Remote File .........+.2.2.. dname(1M) 
dn_comp, dn_expand: resolver... 2... 1 ee ee resolver(3) 
dn_expand: resolver routines. . 2... 2 6 2 1 ee ee resolver(3) 
documents formatted withthe .........+..4.6.4 mm(1) 
documents. mm:the MM .........2..4+4506 mm(5) 
documents, view graphs,and .... 1... 2 ee eee mmt(1) 
dodisk, lastlogin, monacct, . . .......-+-.2-. acctsh(1M) 
Goma Wiel s- ao se ee en we SSE A . whodo(1M) 
domain and network names. . . . 1. 1 ee eee dname(iM) 
domain mame server. . 1... 2 2 eet ew ewes named(IM) 
double-precision number... . 2... 1 es eee strtod(3C) 
download: 4d)... f-8 eB Se ee eR. SS tdl(1) 
drand48, erand48, Irand48, .........64084 drand48(3C) 
GIAW BS RTADN: ke a ee graph(1G) 
drill in number facts. 2... 1. 1 ee ee eee arithmetic(6) 
drive parameters fortape . 2... 2. 22 ee eee tapeset(1M) 
drive specificinformation ........-24.04.4. tapedrives(4) 
ETLVE:. 1SIOUU So ie ocd Wiest OS el 2 -  e es B S AE tsioctl(1) 
Gtiver: cloWe:: Open: i. eos se 6 es ee Sw eS clone(7) 
GTVGl. ok: 4.6. GO aie eee ee ee ie: een eS disk(7) 
GOVGES.. cg Re he ee os a BP  “ Iddrv(1M) 
drivers: loadable device... 1.1... ee we eae drivers(7) 
drvload, powerfail: sysiem .....-. 1. eee eee brc(1M) 
dtoc, ttoc, vioc: graphical . 2 1 1 ww 1 ee et ts toc(1G) 
du: summarize disk usage. . «1. 1 1 ee ee ew ee du(iM) 
dump. /extract errorrecords . . .. 1. 2. ee. 1 ee errdead(1M) 
GUID: 3528 2b ee. eb, Yee eS ea Ee eS ae ie os hd(1) 
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od: octal 

object file. dump: 
descriptor. 

descriptor. 

descriptor. dup: 
descriptor. dup2: 

echo: 

network/ ping: send ICMP 
floating-point number to/ 


program. end, etext, 

ex for casual users). 

sact: print current SCCS file 
/(visual) display 

ed, red: text 

ex: text 

files. Id: link 

ged: graphical 

common assembler and link 
sed: stream 

casual users). edit: text 
Jdeeprom: load 

juser, real group, and 

and/ /getegid: get real user, 
language. 

split FORTRAN, ratfor, or 
pattem using full regular/ 


enable/disable LP printers. 
accounting. acct: 

real-time priorities 

enable, disable: 

crypt: 

encrypt: generate hashing 
crypt: password and file 
makekey: generate 

locations in program. 
/getgrgid, getgmam, setgrent, 
/gethostent, sethostent, 
/getnetbyname, setnetent, 
socket: create an 

bind an address to a iranspon 
t_close: close a transport 
current event on a transport 
t_open: establish a transport 
manage options for a transport 
t_unbind: disable a transport 
/getprotobyname, setprotoent, 
/getpwuid, getpwnam, setpwent, 
/getservbyname, setservent, 
getspent, getspnam, setspent, 
utmp/ /pututline, setutent, 
convert Arabic numerals to 
processor. 

getdents: read directory 

nlist: get 

file. linenum: line number 
file/ /manipulate line number 


GUMID:,. ..:6) 38. Hw oS) ee ee ee ee BES ee od(1) 


dump selected partsofan  .. 1... 6 1 ee ee ees dump(1) 
dup: duplicate an open file... . 2... 6... 80208. dup(2) 
dup2: duplicate an open file . . 1... 1... eee dup2(3C) 
duplicate anopenfile . 2. 2... 6. ee eee te ee dup(2) 
duplicate anopenfile . 2... 1... ee ee ee ee dup2(3C) 
CChO BIQUMENtS... . Bs-5 Se ewe Sow. SP SO Ee echo(1) 
ECHO_REQUEST packets to . 2. 2. 2 eee ee ping(1M) 
ecvt, fevt, gcvt: convert 2. 6 6 6 ee ee ee te es ecvt(3C) 
ed, red: texteditor, 6... 0 0 et te ee tt te tw ed(1) 
edata: last locations in . . 2. 1 ee ew ee ee ee end(3C) 
edit: text editor (variantof 2... 6 6 1 ee ee ee ee edit(1) 
COMING ACUVILY.< 6 5g ee a eas a Sw Sw AS sact(1) 
editor based onex. . 2. 2 1 6 ee ee ee ee we es vi(1) 
COMNOL:. ee EE ee a See ee we ed(1) 
COUOK: fer ec EW eres: el Be Hd: SBOE, Ge eee, He ex(1) 
editor forcommon object . 6. 6. 6 6 ee ew ee ee ld) 
CONOE. 6526 eS ee ee MS ee Ree ged(1G) 
editor output. aout: 2. 6 1 wee ee ee ee ee a.out(4) 
CQUIOT: oo fe SE) ne, eR ES Go OO Ow Sete BG sed(1) 
editor (variant ofexfor . 2... 6 6 2 ee ee we ee edit(1) 
BEPROMG we se de 4 ee Son ie WK EN We GS ldeeprom(1M) 
eflective group IDs... sec eS ee So Bee getuid(2) 
effective user,real group, .. 2... 2-1 eee ees getuid(2) 
efl: extended FORTRAN . 1. 1 1 1 ee ee ee efi(1) 
efl files: Isplits ce 6: oe ge i Ae we ee & SOS fsplit(1) 
egrep: searchafilefora 2... 1 1 ee eee ee ew egrep(1) 
en: Ethernet Processor. 29.06 6 ss ee 6 8 ee ee es en(7) 
enable disable: 0. 65 4 6 WR aa ee we RL enable(1) 
enable or disable process . . . 6. 1 ee eee eee acct(2) 
enabled/disabled. rtpenable: . . .. 1... 08. rtpenable({1M) 
enable/disable LPprinters. .......-4..0.6- enable(1) 
encode/decode, . .06 6 sce ce ee ee ew crypt(1) 
encryption. crypt, setkey, . 2. 2 2 1 1 2 ee ew eee crypt(3C) 
encryption functions, . . 1... 1 ee ee ee es crypt(3X) 
encryption key. 6-4. 6s wee & eee So eo we makekey(1) 
end, etext, edata: last. 1 1 we we ee et ee end(3C) 
endgrent, fgetgrent: get group/  . . 2... ee eee getgrent(3C) 
endhostent: get network host/ . ........ gethostbyname(3) 
endnetent: get network entry, ......+.2.-. getnetent(3) 
endpoint forcommunication. ... 1... 6 ee eee socket(2) 
endpoiit) t binds 4.6.55 aoe ae ee eee eS Be t_bind(3n) 
ONEPOINE. 2s 54 eins ee a es i we Ss eR oe ee t_close(3n) 
endpoint. t_look: look atthe . . 1... 1... 2. eee t_look(3n) 
GNADOINE: 2s ee So ee eS Se SS , Ses t_open(3n) 
endpoint. tloptmgmt: ... 2... 2 ee ee ee 1_optmgmt(3n) 
ENADOING: 24s ee Oe ok a a te a we t_unbind(3n) 
endprotoent: get protocol/ 2... 6. 6 ee ee ee getprotoent(3) 
endpwent, fgetpwent: get/ . 2... 1 ee ee eee getpwent(3C) 
endservent: get service entry. . . ..- 2. ee ee getservent(3) 
endspent, fgetspent, lckpwdf,/ ...-....-+.-. getspent(3X) 
endutent, utmpname: access .... 2... ee wees getut(3C) 
English. number: . . . . 2. 6-2 2 2 wee eee number(6) 
enpstart: configure Ethemet .. . 2... ...... enpstart(1M) 
entnes and putinafile, 2... 2... 1... 2 eee getdents(2) 
entries from mame list. «2. 1. 1 1 1 we et te et nlist(3C) 
entries in acommon object . . 2... 6-6 1 ee eee linenum(4) 
entries of acommon object 2... 1 ee ee ee Idlread(3X) 
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/\dnlseek: seek to line number 
/dnrseek: seek to relocation 
system independent directory 
utmp, wtmp: utmp and wimp 
fgetgrent: get group file 
endhostent: get network host 
endnetent: get network 
endprotoent: get protocol 
fgetpwent: get password file 
getrpcbynumber: get rpc 
endservent: get service 
utmpname: access utmp file 
object file symbol table 

/the index of a symbol table 
/read an indexed symbol table 
putpwent: write password file 
write shadow password file 
unlink: remove directory 
command execution. 


cprofile: setting up a C shell 
profile: setting up an 

AIEEE floating point 

environ: user 

execution. env: set 

getenv: return value for 
putenv: change or add value to 
performed for multi-user 

stop the Remote File Sharing 
interface, and terminal 
character definitions for 
remove nrofffroff, tbl, and 
mathematical text for nroff/ 
definitions for eqn and neqn. 
thosts: remote 

mrand48, jrand48,/ drand48, 
graphical device/ gdev: hpd, 
complementary error function. 


and status information from/ 


format. 

system error/ perror, 
function and complementary 
receive a unit data 

strclean: STREAMS 

strerr: STREAMS 

log: interface to STREAMS 
t_error: produce 

sys_errlist, sys_nerr: system 
to system calls and 
information/ errdead: extract 
serstat: display serial port 
matherr: 

errfile: 

errdemon: 

errstop: terminate the 

err: 


entries of asection ofa/f .. 1... 2 1 ee ee ee Idlseek(3X) 
entries of asection ofa/ . 1. 1. 1 6 1 ee ee ee Idrseek(3X) 
entry. dirent: fle 2. 2 6 2 2 ce ew ee ee wee dirent(4) 
entry formats. . 2... 6 ee ee ee eet ee es utmp(4) 


entry. /setgrent,endgrent, .......+-+- . . getgrent(3C) 
entry. /sethostent, . 2... 2-6 + ee ee es gethostbyname(3) 
entry. /senetent, . . 2-2 ee ee ee ee ee getnetent(3) 
entry. /setprotoent, . 2. - 1 2 ee ee ee eee getprotoent(3) 
entry. /setpwent, endpwent, .....-. 2 2 es getpwent(3C) 
entry. /getrpcbyname, .. 2. 6 ee ee ee ees getrpcent(3) 
entry. /setservent, 2... 2 6 eee ee ee ee getservent(3) 
entry. /setutent, endutent, . .. . - - es + + we eee getut(3C) 
entry. /symbol name forcommon ........ Idgetname(3X) 
entry of acommon object fle. . .....- 2... Idtbindex(3X) 
entry of acommon object file. . . . 2... +. 2s ldtbread(3X) 
CHU. Wi ks 6 6 a So wt putpwent(3C) 
entry. putspent: 2. 2 6 6 1 ee eee ee ee putspent(3X) 
CMT, 5 enw: cect: nee! Se ai Sasa AS ese ee unlink(2) 
env: set environment for... 2. 1. 2 6 ee ee ee ee env(1) 
environ: userenvironment. . . . 2... + + 6 © ee environ(5) 
environment atlogin time. . . 2... + 1 ee we wee cprofile(4) 
environment atlogintime. .. . 2... - + ee eee profile(4) 
environment control . 2... 6. 6 6 ee ee we fpgetround(3) 
CHVIFORIMIENES.. ig 6 Soe ee ewe es es ee environ(5) 
environment forcommand ..... 2... + es eee » env(1) 
environment name. . . . 1. 1 6 1 6 ee ee ee getenv(3C) 
environment. . 6. 2. 6 6 6 1 we ee ew ew wt tw putenv(3C) 
environment. /runcommands .........4s4ee-e rc2(1M) 
environment. rfstop: . 2... 6 6 + ee ee ee rfstop(1M) 
environment. flerminal .. . . 1. 1 1 1 ee ee we tset(1) 
eqn and negn. /special . . 2 2 1 1 ee et te eh ee eqnchar(5) 
eqn constructs. deroff: . 2. 2 6 1 6 ee ee ew ee ew deroff(1) 
eqn, neqn, checkeq: format . . 2. 2 2 2 ee ee ee es eqn(1) 
eqnchar: special character... 1 6 we ee ees eqnchar(5) 
equivalent users. 2. 6 2 0 ss se te wh ee te rhosts(4) 
erand48, lrand48, nrand48, ....... +. wes drand48(3C) 
erase, hardcopy, tekset,td: 6. 1 1 ee ee et ee ew gdev(1G) 
erf, erfc: errorfunction and ..... 2. 6 1 ee ee ee erf(3M) 
err: error-logging interface. . 2. 2. 1. 6 6 ee ee we ee err(7) 
errdead: extract errorrecords ......66 +. . errdead(iM) 
errdemon: error-logging demon. ......... errdemon(1M) 
errfile: error-log file . . 2... 1. se + eo wo we wo wo ermfile(4) 
ermo, sys_errlist, syS_nerr: . 1. 1. - ee ee ew ee perror(3C) 
error function. ferfc:error «1 ww we ee et tt erf(3M) 
error indication. t_rcvuderr: ........44-6. t_rcvuderr(3) 
errorlogger cleanup program. . . . 1... 2 eee strclean(1M) 
errorlogger daemon. .....-+- +++ ee e+ eee strerr(1M) 
errorlogging andevent/ ...... + + ee es we eee log(7) 
CINOL MCSSARE:- ois Bw Ge a a ee t_error(3n) 
error messages. /ermo, . . . . 2 2 6 + se ee ww perror(3C) 
error numbers. fintroduction . . . 1... 2. 1 ww wee intro(2) 
error records and status . . . 1. 1. 1 eee ew wee errdead(!M) 
ernor stalistics.; 2. 4 és owe ae es Se serstat( 1M) 
error-handling function. . . . 1... 6. ee eee mather(3M) 
error-log filleformat. . . 2... 2... 2 ee ee wine errfile(4) 
error-logging demon. . . . . 2. 2 6 se ee ew errdemon(1M) 
error-logging demon. . . . - . 2 6 se ee ew ee errstop(1M) 
error-logging interface. . . 1... 2 5 ee ee eee . em(7) 
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process a report of logged 
hashcheck: find spelling 
error-logging demon. 
another transpory/ 1_connect: 
endpoint. t_open: 

terminal line/ dial: 

setmnt: 

with information from 

with information from 
pwconv: install and update 
pwunconv: install and update 
Ainformation used by the 

in program. end, 

en: 

enpstart: configure 

hypot: 

expression. expr: 

test: condition 

t_look: look at the current 

to STREAMS error logging and 
notify, unnotify, evwait, 
notify, unnotify, 


edit: text editor (variant of 


display editor based on 

crash: 

a file. locking: 

execve, execlp, execvp:/ 
execlp, execvp: execute/ exec: 
execvp:/ exec: execl, execv, 
/execl, execv, execle, execve, 
path: locate 

execve, execlp, execvp: 
construct argument list(s) and 
time. at, batch: 

regcemp, regex: compile and 
requests. uuxqt: 

set environment for command 
sleep: suspend 

sleep: suspend 

monitor: prepare 

romd: remote shell command 
rexecd: remote 

profil: 

UNIX-to-UNIX system command 
execvp: execute/ exec: execl, 
exec: execl, execv, execle, 
fexecv, execle, execve, execlp, 
a new file or rewrite an 

exit, 

exponential, logarithm ,/ 

peat, unpack: compress and 
to spaces, and vice versa. 
t_snd: send data or 

t_rcv: receive data or 

advent: 

exp, log, log10, pow, sqrt: 
exports: NFS file systems 


CITOM: CIOS eich ee BS ORL GR ee BR errpt(1M) 
errors. fnashmake, spellin, . . . 1... 2 1 ee we spell(1) 
errstop: terminate the . 2. 6. eee ee ee errstop(1M) 
establish aconnection with ........-88- t_connect(3n) 
establish atransport . 2... 2 2 ee ee ee ee t_open(3n) 
establish an out-going . 2. 2. 6 1 ee ee ee ee ws dial(C) 
establish mount table. . .. 1... - 2. es se eee setmnt(1M) 
fetc/passwd. //etc/shadow «2 ww ee ee ee ee pwconv(IM) 
etc/passwd. /fetc/shadow  . 1 ww ee ee ee pwunconv(1M) 
fetc/shadow with information/ . ........4.6-. pwconv(1M) 
fetc/shadow with information/ .........-. pwunconv(1M) 
fetcAapeset command... . . 2... 2. 2 2s we ee tapedrives(4) 
etext, edata: last locations .... 2... + ee. sees end(3C) 
Ethemet Processor, . 2... 6 ee ee ee we we we es en(7) 
Bthemiet processor 9s: 4. be ess we ws enpstart(1 M) 
Euclidean distance function. . 2... 2...) ee ee hypot(3M) 
evaluate arguments asan 2. 7 ww ee we ee ee expr(1) 
evaluation command. .... 1.2.26 6 2 ee ee we test(1) 
event on atransport endpoint. . . 2... 1... ee ee t_look(3n) 
event tracing. log: interface... 1 1 1 ee ee ee log(7) 
evnowait: manage/ . . 2 2. 6 1 ee ee ee ee notify(2) 
evwail, evnowalt: manage/ . .....-..-2e8+:-: notify(2) 
ex forcasual users), 2. 2 0 ec te te te we te te ew edit(1) 
OX: TERE CUUOE. 5 as: 3k Sel ea ee re A ee a ex(1) 
ex. /screen-oriented (visual) . 2... 1 1 1 ee ee we ee vi(1) 
examine sysiem images. . . . 2... 6 ee we eee crash(1M) 
exclusive access toregionsof ..... 1... ee oe locking(2) 
exec: execl,execv,execle, . 2... 2. 6 ee ew we ee exec(2) 
execl, execv, execle,execve, . . 1. 2 2 1 2 ew we ee exec(2) 
execle, execve, execilp, . 2. 6 6 se ett tet exec(2) 
execlp, execvp: execute af ww ww ee wt ee et exec(2) 
executable file forcommand. ...... +++ -+« ees path(1) 
execute a file. fexecle, 2. 0. 0 6 6 ee ww ee ee exec(2) 
execute command. Xargs:  . 1 1 se ee ee we ee xargs(1) 
execute commands atalater . ..... 2.1 es se eee at(1) 
execute regular expression. . .- . +. 1 2 2 eee regemp(3X) 
execute remote command .....-.. eee eee uuxqt(1M) 
CXECUUION CAVE. Scout G32 we Seat Some Sn ewe env(1) 
execution foraninterval, . . 1. 1 1 2 ee ew we ew sleep(1) 
execution forinterval . 2. 1 6 ee ee ee ee ee sleep(3C) 
execution profile. . . 1... 1.52. 6 2 ee wees monitor(3C) 
CXOCINON, 6-2 be be. Se SO Se eee Se Oa. Se romd(1) 
CKECINION. SEPVES: os kk ee Ss ee ae we RS rexecd(1M) 
execution time profile. . . . 2... 2 1 ee ee ees profil(2) 
CXOCUUON, URS! He ae sees Se a He SK, LR. uux(1C) 
execy, execle, execve,execlp, . . 1... 2... ee eee exec(2) 
execve, execip; execvp:/. 6 6s sk be i we Hes exec(2) 
execvp: execute afile, 2. 6 06 wh et ee te ww exec(2) 
existing one. creat: create 2 6 1 1 we ee et es creat(2) 
_exit: terminate process. . 2. 6 6 ee we ee ee exit(2) 
exp, log, loglO, pow, sqrt: 2... 6 1 ee wee th ws exp(3M) 
expand files. pack, . 2. 2 6. 1 ee ee ee ee ewe pack(1) 
expand, unexpand: expandtabs  . . 2. 2... 1. we expand(1) 
expedited dataovera/ . 2... ee ee ee ween t_snd(3n) 
expedited data sent overaf 2. ww ee we ee t_rev(3n) 
explore Colossal Cave. . 2. 1 6 6s ee ew we wees advent(6) 
exponential, logarithm, power/ . ........0848-5 exp(3M) 
export configuration file. . 2... 2 6 ee ee eee exports(4) 
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export configuration file. 
expression. 

routines. regexp: regular 
regcmp: regular 

expr: evaluate arguments as an 
compile and execute regular 
a pattern using full regular 
efl: 

extproc: tum 

programs. Xxstr: 

status information/ errdead: 
in a file. strings: 

remainder,/ floor, ceil, fmod, 
drive. tsioctl: 

factors of a number. 

factor: obtain the prime 
fasr/adm/loginlog: log of 
true, 

data in a machine-independent 
finc: 

/calloc, mallopt, mallinfo: 

a stream. 


floating-point number/ ecvt, 
fopen, freopen, 

status inquiries. ferror, 

fileno: stream status/ 

firstkey, nextkey:/ dbminit, 
fora file system. 

stream. fclose, 

word from a/ getc, getchar, 
/getgmam, setgrent, endgrent, 
/getpwnam, setpwent, endpwent, 
stream. gets, 

/getspnam, setspent, endspent, 
character string. 

times. ufime: set 

Idfcn: common object 
determine accessibility of a 
/2645A terminal tape 

lar: lape 

cpio: copy 

pwck, grpck: password/group 
chmod: change mode of 
change owner and group of a 
mcs: manipulate the object 
diff: differential 

diff3: 3-way differential 

fend: 

fontl: 

conv: common object 

rcp: remote 

public UNIX-to-UNIX system 
core: format of core image 
cprs: compress a common object 
umask: set and get 

crontab: user crontab 


exports: NFS file systems . . 2... + - 2 ee ee ee exports(4) 
expr: evaluate arguments asan . 2... 2 6 ee ee ees expr(1) 
expression compile and match . . .. 2 - ee eee regexp(5) 
expression compile. . 2. 6. - + ee ee regcemp(1) 
CKEWENSIONS. Ge coe ei a; Eh oS a GS a we CW es Sa expr(1) 
expression. regcomp, regex: . - - ee ee ee eee regcmp(3X) 
expressions. fafilefor . . 2... 6 6 1 eee ee eee egrep(1) 
extended FORTRAN language. . . 2. 2. 2 6 ee ee ees efi(1) 
extemal processing onoroff, 2... 2.2 + eee extproc(!M) 
extract and share strings inC . . 2... 2 se se ee eee xstr(1) 
extract errorrecordsand ...... 26 + e+ 2 eee errdead(1M) 
extract the ASCII text strings .. 1... - ee eee strings(1) 
fabs: floor, ceiling, . © 2-6 ew ee ee te ee floor(3M) 
facilitate usage ofatape . 2. 1-2 ee ee ee es tsioctl(1) 
factor: obtainthe pnme «ww we ee ee ee es factor(1) 
factors ofanumber. . . 2. 2 2 2 ee te ee ew we we factor(1) 
failed login atlempts. 2... 2. 2 1 ee ee ew eee loginlog(4) 
false: provide truth values. . 2. 2 6 6 ee ee ee ee es true(1) 
fashion. /accesslong integer . . . 2. 2. 2 6 2 ee eee sputl(3X) 
fast incremental backup. . . . 2. - 6 2 + ee ee ees finc(i1M) 
fast main memory allocator. . ..... ++ ee es malloc(3X) 
fclose, flush: close orflush . . . .-.. +--+ - =: + - felose(8S) 
fontl: file Gontrol:. 6.6. so se 2.0 sh? ae ee a a we fentl(2) 
fentl: file control options, ©... 6 6 6 ee ee ee ee fentl(5) 
fcvt, govt: convert 6 ww ee ee ee ee ee es ecvt(3C) 
fdopen: open astreaam,. 2... 2 2 ee ee ee ees fopen(3S) 
feof, clearerr, fileno: stream ...... 2.2.56 .66-. ferror(3S) 
ferror, feof, clearerr, . 2... 6. 1 ee ee we et ww ferror(3S) 
fetch, store, delete, 2. 6 6 6s eS eee ee dbm(3X) 
ff: file names and Statistics . . 2... 2 1 ee we ee eee ff(1M) 
fflush: close or flusha . 2. 1 1 wee ee ee we fclose(3S) 
fgetc, getw: get characteror . . . 1 2 2 ee ee ee getc(3S) 
fgetgrent: get group filef/ ..... 2. 2. 2. ee eee getgrent(3C) 
fgetpwent: get password file/ . . .... +... es getpwent(3C) 
fgets: getastring froma . . 2... 6 2 eee ee ee gets(3S) 
fgetspent, Ickpwdf, ulckpwdf:/  . 2... ee wa getspent(3X) 
fgrep: searchafilefora . 2... 1 ee ee ee eee fgrep(1) 
file access and modification .......+6.-2 6.064806 utime(2) 
file access routines. . 2. 2 1. 7 1 2 ee wee ee ww Idfcn(4) 
Fil@: ACCES Ee. od. <g> ide Et wo a Wt access(2) 
hlearchiver.:. 4..6-4.iot a GE ee Re ee a ee hpio(1) 
HEATER: eee ew Es eS ee See: SE So we SES tar(1) 
file archives in and out. . 2... 1 1 ee ee ew ew we cpio(1) 
file CHeECKElS 36-66 5, 6. 48 a Sas BT oat ape pwck(1M) 
Mee. b.4 ae ae BR a a, OR OO chmod(2) 
file; CHOWN: © ce KH fa ee We SE BOGE chown(2) 
file comment section. . . 2... 6 6 6 ee eee ee es mcs(1) 
file comparator, 2. 6 2 5 ee wt te we tw te we diff(1) 
file: COMPpA@TISON. - 6: 4. Kw A a SO SS diff3(1) 
RIE GONITOL: ee ae eS WS fentl(2) 
file control options. 2.6.6 6 we ee eH we eS wwe fentl(S) 
fle CONVENED, oie See we OS wR we conv(1) 
fl COPY s.. 6..4 OS A Se a we Oe eh te rcp(1)} 
file copy. uuto, uupick: 2. 1 we ee ee ee uuto(1C) 
files en 6. elk RS es Be A ee Se ea core(4) 
Piles. isis i. ce ia a Gos 5 he Cem Se ee cprs(1) 
file creation mask. .. . 1. 1 6 6 ee ee ew wee umask(2) 
AG es ae ae dar DCG ve the Ae es ee ae Soe ae ee crontab(t) 
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clags: create a tags 

fields of each line of a 
using the mkfs(1) proto 

dd: convert and copy a 

a delta (change) to an SCCS 
close: close a 

dup: duplicate an open 
dup2: duplicate an open 


hd: hexadecimal and ascii 
selected parts of an object 

sact: print current SCCS 

crypt: password and 

endgrent, fgetgrent: get group 
fgetpwent: get password 
ulmpname: access utmp 
putpwent: write password 
write shadow password 

execlp, execvp: execute a 
systems export configuration 
fgrep: search a 

grep: search a 

reguiar/ egrep: search a 

path: locate executable 
inetd.conf: configuration 
Idaopen: open a common object 
netrc: login 

aliases: aliases 

lines. Devices: configuration 
acct: per-process accounting 
ar: Common archive 

errfile: error-log 

intro: introduction to 

entries of a common object 
gateways: routed configuration 
get: get a version of an SCCS 
directory entries and put in a 
group: group 

files. filehdr: 

limits: 

constants. unistd: 

file. idfhread: read the 
Idohseck: seek to the optional 
split: split a 

issue: issue identification 

of a member of an archive 
close a common object 

file header of a common object 
a section of a common object 
file header of a common object 
a section of a common object 
header of a common object 
section of a common object 
table entry of a common object 
table entry of a common object 
table of a common object 
entries in a common object 
link: link to a 


Nes 2 86. 4 S-o w e ERE S eMS e e S ctags(1) 


file. cut: cut out selected 2. 2. 2 1 1. 1 we eet ee cut(1) 
file database. /sofiware  . 2. 1. 1 ew ee ee qinstall(1) 
TOS. reise RE Ge a ER De a oh GR a ES dd(1M) 
file: delta: mak@:. -si¢-0. eices sw BO oe we. ee ee we delta(1) 
le descnimor. i. 6. 6:2. aes Geeks oe GG ee Ee close(2) 
file descnptor:: «4... soe eS Se ee dup(2) 
file descriptor, <5 sk ek a dup2(3C) 
file: determine file type. . 2... 2 2 ew ee ee ee ee file(1) 
file dump... 3. .0 és) 6 Bow So eS ee ee ae hd(1) 
file. dump: dump . . . 2.6 6 2 ee ee ee eee ee dump(i) 
file editing activity, . 2... 1. 6 ew ee ee eee sact(1) 
file encryption functions. . 2... 6 6 ee ee ee ee crypt(3X) 
file entry. /setgrent, . . 2. 6. 2 2 ee ee ee ee getgrent(3C) 
file entry. /endpwent, . .. 2. 2. - 6 2 2 ee ees getpwent(3C) 
file entry. /endutent, . . 2... 6 2 6 ee we we wee getut(3C) 
ARO CRLY a= See se Sse. a Ss 1, Lo a Ss putpwent(3C) 
file entry. putspent: 2... 6 2 ee ee ee ee putspent(3X) 
file. /execv, execle, execve, . 1. 2 1 6 ee ew ee ew exec(2) 
file. exports: NFSfile . 1... 2 6 2 ee eee eee exports(4) 
file fora character string. . 2. 2 6 1 ew ee ee ee fgrep(1) 
fileforapattlem,. . . 2.2 26 ee ee eee wee grep(1) 
file fora pattem using full . ...- 2. e+ ee eevee egrep(1) 
fileforcommand. ... 2. 6 1 0 ee ee ee ee ee path(1) 
file for inetd (internef¥ 2. 1. 1 ww ww ew ee ee inetd.conf(4) 
file for reading. Idopen, . . . 2... ee ee ee ee Idopen(3X) 
file for remote networks. . 2... 6. 2 6 ee eee ees netrc(4) 
fileforsendmail, . . 1... 6 6 we ewe ee wae aliases(4) 
file for uucp communications .... 2. + +e ees Devices(5) 
fileformiat:- 6c 4 We. & tne oe See eR ew acct(4) 
file formats. 3-46: Gos Se etd ee A ee ar(4) 
file tomas: 6 4c: a SS BE errfile(4) 
fileformats:. 9: 4 a2 4) 6-47 a. BOR Oe ee a intro(4) 
file function. fline number . . 2... ee eee ee Idlread(3X) 
fle ge Mee ee Se oe ee ae Se gateways(4) 
Qlé:. 4 :s4-e es SO BOE OSES Boe eK eee get(l) 
file. getdents: read 2. 1 ww wt te eh we et ws getdents(2) 
HG se oh ap gh SR a Sa BA, eS ke ce selec tw) a cee ee“) group(4) 
file header forcommon object... 2 1 1 ee ew ee filehdr(4) 
file header forf 2... 6 1 ee ee et ee tt te himits(4) 
file header forsymbolic . . 1... 1 6 6 2 ee ee unistd(4) 
file header of acommon object. 7 we we ee \dfhread(3X) 
file header of acommon object/ . . . . 1... Idohseek(3X) 
file IN1O PIECES: owe is: ete ee OE split(1) 
Gs: . ond} 03 de Se ee Some Eas Se He ES issue(4) 
file. fread the archive header . 2... 2. 2. we ee Idahread(3X) 
file. ldclose, Idaclose: ......+ 26-44-2268 6 Idclose(3X) 
file. ldfhread: readthe . 2... 1 1 ee we we idfhread(3X) 
file. fine number entries of ........2...-. Idlseek(3X) 
file. seek tothe optional . ...... 2-26 ee Idohseek(3X) 
file. /relocation entriesof ...... 2.2.22 eee ldrseek (3X) 
file. Andexed/named section ......+.24e446- ldshread(3X) 
file. Ato anindexed/named ..........206: ldsseek(3X) 
file. Ahe index ofasymbol ........4... Idtbindex(3X) 
file. read anindexed symbol ..........-. Idtbread(3X) 
file. fseektothe symbol .... 2... 2 ee eee Idtbseek(3X) 
file. linenum: line number .. . 1... 6 1 6 ew we ee linenum(4) 
Ales «ao ost a Be A Se eB link(2) 
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listing from a common object 
set links/ glist: print out 
access to regions of a 
masterupd: update the master 
make an ifile from an object 
mknod: build special 

or a special or ordinary 
ctermid: generate 

mktemp: make a unique 

for a file system 

netcf: Network Configuration 
data base for the mail aliases 
change the format of a text 
name list of common object 
null: the null 

/find the slot in the utmp 
Adentify processes using a 
one. creat: create a new 
passwd: password 

or subsequent lines of one 


Ps: 

‘rewind, ftell: reposition a 
Iseek: move read/write 

prs: print an SCCS 

queue description 

read: read from 

for a common object 

resolver configuration 

Sharing name server master 
remove a delta from an SCCS 
bfs: big 

two versions of an SCCS 
sccsfile: format of SCCS 
header for a common object 
format of curses screen image 
/out file lists from proto 
shadow: password 

rfadmin: Remote 

tfudaemon: Remote 

network/ dname: print Remote 
rfstop: stop the Remote 
tfpasswd: change Remote 
master file. rfmaster: Remote 
query. nsquery: Remote 

shell/ rfuadmin: Remote 
unadv: unadvertise a Remote 
/mount, unmount Remote 
rfstart: start Remote 

mapping. idload: Remote 
fsize: report 

stat, fstat: get 

the ASCTI text strings in a 
from a common object 
processes using a file or 
checksum and block count of a 
swrite: synchronous wnite on a 
/symbol name for common object 
syms: common object 


file. list: produce Csource . . 2. ee eee ee es list(1) 
file lists from proto file; 2... 6 6 6 2 ee ee ee eee glist(1) 
file. locking: exclusive ......-.--. . . . .« locking(2) 
Gil@, > ie, eS er ae. 6 ei. es ep SS. HE SS, BOA . masterupd(1M) 
file. mkifiles ©. so) ek woe we os eo at 8 ee . mkifile(1M) 
Nes). ao tea Ge eee ue, ee A ee A ee mknod({1M) 
file. Amake adirectory, . . . - 6 1 ee + ee we eee mknod(2) 
filename forterminal. ...... + + e+ e ees ctermid(3S) 
filetiames: 3:46 G5. 4g. em Aa ee SS mktemp(3C) 
file names and statistics 2... 6 6 + ee ee ee ee ff(1M) 
Paes: 6s Sessa ee: ees a ae See netcf(4) 
file. newaliases: rebuild the ......+-+.+-4+.-. newaliases(1) 
file. newform: . . 2 6 2 6 0 ee ee we et ee newform(1) 
file. nm: print 2... 1 ee ee ee ee ee ee ee nm(1) 
Ailey. ik &. Sows ere Se SS, Se ES SS ES null(7) 
file of the current user. . 2. 2. 2 1 ee ee ee ew ees ttyslot(3C) 
file or file structure. . 1. 6 1 1 ee ew ee ew ees fuser(1M) 
file or rewrite anexisting . . 6. 6 2 1 ee ee te we ww creat(2) 
Ga 4 ee ta oi BY ee hee Ee ke A a passwd(4) 
file. flines of several files . 2... 2. 1. 2 eee ee eee paste(1) 
file perusal filter forCRTs. .....-..-. +--+. eee, pg(1) 
file pointer inastreaam. 2... 6 6 eee ee ee ee fseek(3S) 
file pointer, 2... 1 ee ee ee ee ee ee we es Iseek(2) 
GB gies oar ee a EO ee SS OS prs(1) 
file. fat/batch/cron  . . 1 1 ee ee te we ew ew ew queuedefs(4) 
Glee Senha a ee ie OB Hae read(2) 
file. /relocation information . . . . . 6 6. 6 6 ee ee reloc(4) 
filé;.resolv.conf= 34 seek & Oe MH SO a resolver(4) 
file. rfmaster: Remote File . .......+ +6448. rfmaster(4) 
file: amidels”. - 2%. 0a 2s. HW, SIS ee RS Er ee rmdel(1) 
file SCanner. wy: 15. fh --3. Wo ee a SO Se bfs(1) 
file. sccsdiff: compare .... 2-2. 2 se ee «ees sccsdiff(1 ) 
Ales 25 38s ka, A ER Se a a Se RS % sccsfile(4) 
file. scnhdr: section . 2... 6 ee ee ee te ew he scnhdr(4) 
file..-scr:GUMp? 3.3 =: ca, 8 SW Ge BP ee ee scr_dump(4) 
file; set links based on. . . 2. 6 ee ee ee wwe glist(1) 
GOs, 2k pc he apser le eed eee ee, Hn Ss HA BIG shadow(4) 
File Sharing administration, .......--..42-+. rfadmin(1M) 
File Sharing daemon process. . . . . 2. ee es rfudaemon(1M) 
File Sharing domain and... 1. we ee ee ee dname(1M) 
File Sharing environment. . . . 2.2 6 +e ee ee rfstop(1M) 
File Sharing host password. . ... 2.2. + 2 eee rfpasswd(1M) 
File Sharing name server... we ee ee ew ee rfmaster(4) 
File Sharing name server . . . 2... 2 2 ee ea nsquery(1M) 
File Sharing notification . .. 1... 2s wae rfuadmin(1M) 
File Sharing resource. . . 2 1 1 1 ee he ew ees unadv(1M) 
File Sharing (RFS) resources. . . 2... ee 2 ws rmountall(1M) 
Fre Sharing: a. 45 6.-k: Soy Se WM cw WS rfstart(1M) 
File Sharing user and group)... 1 1 ee ee ee idload(1M) 
file SIZES. os -4o a ae, ee ee ee Se eS a as fsize(1) 
le State. a ae ea a ee Se stat(2) 
file. strings: exttact, 06 6 66 6 Se ee Hw es strings(1) 
file. fline number information .... 2... 1 ee ee strip(1) 
file structure. fidentify ........-2+.2606- fuser(1M) 
file:.sumiprint 4: 6 i eel eS ie aes suin(1) 
BENG al ig Sa a as oe hs ote a nas a ee Dw ae eG A EE ees swnite(2) 
file symbol table entry. . . . 2... 2... 2-2. ees idgetname(3X) 
file symbol table format. . . . 2... 1 ee ee ee syms(4) 
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ckbupscd: check 

fsdb: 

volume. fs: 

{styp: determine 

directory entry. dirent: 

statfs, fstatfs: get 

mkfs: construct a 

mount: mount a 

Amount, unmount Network 
nfsstat: Network 

ustat: get 

fsstat: report 

mnttab: mounted 

rmtab: remotely mounted 
sysfs: get 

umount: unmount a 

volcopy: make literal copy of 
system: system description 
/umount: mount and unmount 
configuration/ exports: NFS 
access time. dcopy: copy 
fsck, dfsck: check and repair 
labelit: provide labels for 
mount, unmount multiple 
and/ checklist: list of 

deliver the last part of a 

term: format of compiled term 
tmpfile: create a temporary 
create a name for a temporary 
and modification times of a 
ftp: ARPANET 

fipd: DARPA Intemet 

tftpd: DARPA Tnvial 

uucp system. uucico: 

ftw: walk a 

file: determine 

undo a previous get of an SCCS 
report repeated lines in a 
directories and permissions 
val: validate SCCS 

write: write on a 

umask: set 

common object files. 

ferror, feof, clearerr, 

and print process accounting 
merge or add total accounting 
create and administer SCCS 
link, unlink: link and unlink 
cat: concatenate and print 
cmp: compare two 

lines common to two sorted 
In, mv: copy, link, or move 
mark differences between 

file header for common object 
find: find 

frec: recover 

format specification in text 
FORTRAN, ratfor, or efl 


file system backup schedule. . . 2... 2. ++ 2s ckbupscd(1M) 


file system debugger. . 2 2-6 eee ee ee ee es fsdb(1M) 
file system: format of sysiem . . 2. 2 2) ee ee ee es fs(4) 
file system identifier... 2 2 6 2 6 6 ee eee ee fstyp(iM) 
file system independent... .- + ee eee ene dirent(4) 
file system information .... + - 2s ee ee eee statfs(2) 
file Systm. =. 6.66 Bob ee Re wa mkfs(1M) 
filesystem. . 2... 2 ee ee ete we tee te mount(2) 
File System resources. . 2. 2. 2 1 ee ee ee nmountall(1M) 
File System statistics. ©. 6 2 6 6 ee ee ee ee ee nfsstat(iM) 
file system statistics. © 2 6 6 2 ee eee ee ee ee ustat(2) 
file system status. . 2 2. 2 6 we ee ee te we te es fsstat(1M) 
file system table. 2. 2 1 ee ee ee et ew ee mnttab(4) 
file system table. 2. 2. 2 2 ee eee et te et te te rmtab(4) 
file system type information, . . 1... ee ee eee sysfs(2) 
filesystem. . 2... sss ee ee eee evo ns umount(2) 
filesystem. . 2. 2. 6 ee se ew ee wwe sone volcopy(1M) 
Nie 36S we Ge hie Boe ee eS aS ES es system(4) 
file systems and remote/ . . . 1. 6 1 2 ee ee eee mount(1M) 
file systems export... 6 we eee et ee te exports(4) 
file systems foroptimal . . . 2... 2 ee ee eee dcopy(1M) 
filesystems. 2. 2. 2 6 se ee oe eee eee eae fack(1M) 
file systems. . 2 2 ss ee tee te ewe ew ewe Jabelit(1M) 
file systems. Aumountall: 2... 1 7 we ee ee mountall(1M) 
file systems processed by fsck .... 2. +e ee ee checklist(4) 
Files GM Soc x52. 0 aia an we (SR! oi as SC SE Ge ee tail(1) 
lei aes re. Re oe we os ee eG SH term(4) 
file. ee ors es ees BS er ee eS ee SS tmpfile(3S) 
file. tnpnam,tempnam:  . 2... ee ee ee ee tmpnam(3S) 
file. touch: update access. 7 1 ee ee ee te es touch(1) 
file transfer program. . 2. 6 6 ee eee te te te ftp(1) 
File Transfer Protocol server. 2. 2 6 6 ee ee et ee ftpd(1M) 
File Transfer Protocol server, ... 1... 6 ee eee tftpd(1M) 
file transport program forthe . . 2... 6 2 es eee uucico(] M) 
file HEGS 6 Aie-%: ee Hee We AE es ew, ftw(3C) 
file Type. eo hk ee a Be Be ee eG file(1) 
file. unget: we ee ee unget(1) 
fle WIG? ves he ee 6 BS FR SS uniq(1) 
file. uucheck: check the uucp . . .. 2. - ee eee uucheck(1M) 
Ale: 36.) Sie, ew AIS GS Ewe a Oe SA ee NE we OG val(1) 
flee - wach 8 bees ea ae ee ee eee Se ee write(2) 
file-creation mode mask. ..... 2. 6 ee ee eae umask(1) 
filehdr: file headerfor . . 2... 6 2 6 1 ee we ees filehdr(4) 
fileno: stream status/ 2. 2. 6 1 ew ew we ee te ferror(3S) 
file(s). acctcom: search. ww 1 ee ee ee ee acctcom(1) 
files. acctmerg: . 2 2 6 2 ee et oe ee ren acctmerg(1M) 
files. Bdininis~ -e. ab es 5 <5, Se ew al oa we admin(1) 
files and directories. . 2. 6 1 6 6 es ee ee eens link(1M) 
fileG ss ee ee WR ass RO re SS FB aS cat(1) 
TES. hin ew ere: Bo a ee SS cmp(1) 
files. comm: select orreject 2... 1... 2 2 ee eee comm(1) 
Ales 2Ch... 4 hne Kea eee Re ee a ae: al ewe es cp(1) 
flees iffy: o> os Se a eh ea ce SE ee Se te we diffmk(1) 
files; HlendE: < doxe ew a A a a RO a filehdr(4) 
flees ie. 6k Be ese ae te SE eee ee OR ee ed eS find(1) 
files from a backup tape. . 2. 2 2 6 2 eee ee ee frec(1M) 
files. fepece. <b eis wk eh ce SS fspec(4) 
files. fsplit: split 2... 2 ee ee ee ee ee tw ew fsplit(1) 
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string, format of graphical 
cpset: install object 

language preprocessor include 
intro: introduction to special 
link editor for common object 
lockf: record locking on 
passmgmt: password 

rm, rmdir: remove 

imerge same lines of several 
unpack: compress and expand 
pr: print 

in bytes of common object 
sort: sort and/or merge 
convert: convert archive 
what: identify SCCS 

fstab: 

pg: file perusal 

greek: select terminal 

nl: line numbering 

col: 

tio: tape 10 

graphical device routines and 
tplot: graphics 


find: 

hyphen: 

ttyname, isatty: 

object library. lorder: 
hashmake, spellin, hashcheck: 
of the current user. ttyslot: 
lookup program. 

information server. 

fold: fold long lines for 
dbminit, fetch, store, delete, 
fish: play ‘*Go 

tee: pipe 

/fpgetsticky, fpsetsticky: IEEE 
isnand, isnanf: test for 

ecvt, fevt, gcvt: convert 
/modf: manipulate parts of 
floor, ceil, fmod, fabs: 

cflow: generate C 

fclose, fflush: close or 
remainder,/ floor, ceil, 

width output device. fold: 
stream. 

advertised resource. fumount: 


per-process accounting file 
service request/ nlsrequest: 
ar: common archive file 
errfile: error-log file 

nroff or/ eqn, neqn, checkeq: 
newform: change the 

inode: 

term: 

core: 

cpio: 


files. graphical pnmitive . 2... 6 7 6 ee ee ee ee gps(4) 
files in binary directories. . 2... 2 6 eee ee eee cpset(1M) 
files. includes: determine C .........-22.-. includes(1) 
Ales? o 5i- Gai ts GA Se de res a ee SR is we ee intro(7) 
FG Ss. Teas be Seca as os Re A ee ae A Re a 1d(1) 
Ailes; 25. raises Bi Se eR es SA Se Se, oe lockf{GC) 
files management. . 2... ee ee eee eee passmgmt(1M) 
files or directories. . 2. 2 6 6 ee ee ee we ew tw rm(1) 
files or subsequent lines off . 2. 2 2 6 6 ee ee ee paste(1) 
files. pack, pcat, 6 6 ee ee ee ee ee ee ee pack(1) 
ES, etka RS Sc a OWE SE ae pr(1) 
files. print section sizes ww ww ee te ee ee te size(1) 
GES: © id. esos dG Ss GH See: Be, SE ae wees Se es sort(1) 
files to common formats. . 2. 2. 1. 6 6 6 ee oe ee es convert(1) 
Ales. 3268 oS Beene Fae ee al BG AS SR what(1) 
file-system-table. 2... 2 6 ee ee eee ee ee fstab(4) 
filter for CRIS): ce Sree 6 me oS ae, Se ie eS pel) 
ANG CR 6.5 6 ee A OR yA greek(1) 
lier. i365 ae a. eae ee a OSS Sie eR nl(1) 
filter reverse line-feeds. . 2. 1. 1. 2 ee ee ew we eh we ee col(1) 
PMLET ae >. De es Ye es eS ce ee ses aw a tg) SE we ee a tio(1) 
filters. Aekset,td: - - - - +--+: ::: +: 2: +. . gdevG@G) 
filters. 2. 2 ee we eee ee eee ewe ewww tplot(1G) 
finc: fast incremental backup. . . . . .- + +. 2+ eee finc(1M) 
find files: <a: ss: dee se a eS ae find(1) 
find hyphenated words. . . - 2 2 ee ee ee eee hyphen(1) 
find name of aterminal. .... 2... ee ee ewe ttyname(3C) 
find ordering relation foran . . «2. 2 1 ee ee ee lorder(1) 
find spelling errors. spell, . © 2 2 2 ee ee ee ee ee speli(1) 
find the slotinthe utmp file .........s..- ttyslot(3C) 
finger: user information .... 6 6 + ee ee ee ee finger(1) 
fingerd: remote user. 1 1 ww ee ee te te fingerd(1M) 
finite width output device. 2. 6 6 6 we ee eee ee fold(1) 
firstkey, nextkey: database/ . . . . 2. - 2 2 ee eee dbm(3X) 
Fish hice es “So te ce Be as eS Boe a ee Sa fish(6) 
AMINE. <6 eh ae le ie ee Sa he we es Se Be tee(1) 
floating point environment{/ .....-+-+-++.-. fpgetround(3) 
floating point NaN/ isnan: «ww 7 ee te ee ee isnan(3C) 
floating-point number tof... 6 6 eee ee ee ecvt(3C) 
floating-point numbers. . 2. 2 6 6 ee ee et te es frexp(3C) 
floor, ceiling, remainder/ .. ..-.--.. + +. = = floor(3M) 
flowgraph.. 6.406 6 ew ee ww ee cflow(1) 
flush @:StPEatis: ood. See a ie OS, eS a a we ek fclose(3S) 
{mod, fabs: floor, ceiling, . . . . 6. 2 6 6 2 ew we ew ee floor(3M) 
fold long lines forfinite .. . 1... 1. 2 ee ee wee fold(1) 
fopen, freopen, fdopen: opena . . . . 2-6 ee ee ee fopen(3S) 
forced unmount ofan... 1. 1 6 1 we ee ew furnount(1M) 
fork: create anew process. . . 2. ee ee ee ee te fork(2) 
FORMAL: SCCUS cae ee eK a a ee a acct(4) 
format and send listener . . .... 2.2. se eee nlsrequest(3n) 
TOMM@ts” sé: 3.6 SS eee ee a Ew A ar(4) 
TOWN: 26. Bd ees SS ee a eS ES errfile(4) 
format mathematical textfor . . . . 2... 2 ee eh ee eqn(1) 
format ofatextfile. . . 2... 2.56 2 + ee eee newform(!) 
format of ani-node. . . 2... 2 ee ew we we ww te inode(4) 
format of compiled term file. . 2... 2. 6 1 ee ee term(4) 
format of core image file. . 2... 2 6 eee ee ee core(4) 
format of cpio archive. 2. 2 6 6 6 ee eee ee ee cpi0(4) 
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to8 5. temeiwens: ioe Ae 7 


file.. scr_dump: 

dir: 

/graphical primitive string, 
sccsfile: 

fs: file system: 

files. fspec: 

object file symbol table 

troff. tbl: 

nroff: 

archive files to common 

intro: introduction to file 
wimp: utmp and wtmp entry 
scanf, fscanf, sscanf: convert 
Mfprintf, vsprintf: print 
fprintf, sprintf: print 
/checkmm: print/check documents 
mptx: the macro package for 
mm: the MM macro package for 
ms: text 

man: macros for 

me: macros for 

ASSIST menus and command 
ratfor: rational 

efl: extended 

files. fsplit: split 

hopefully interesting, adage. 
fpgetround, fpsetround, 
fpgetmask, fpsetmask,/ 
ffpgetmask, fpsetmask, 
formatted output. printf, 
/fpsetround, fpgetmask, 
fpsetmask,/ fpgetround, 
point/ /fpsetmask, fpgetsticky, 
word on a/ putc, putchar, 
stream. puts, 

input/output. 

backup tape. 

t_free: 

df: report number of 

memory allocator. malloc, 
matiopt, mallinfo:/ malloc, 
stream. fopen, 

parts of floating-point/ 

frec: recover files 

list: produce C source listing 
/and line number information 
{receive the confirmation 
recvfrom: receive a message 
getw: get character or word 
gets, fgets: get a string 
mkifile: make an ifile 

rmdel: remove a delta 

getopt: get option letter 
t_rcvdis: retrieve information 
records and status information 
etc/shadow with information 
/etc/shadow with information 
read: read 


format of curses screen image Se, a. Goud toe. E scr_dump(4) 
format of directories. . 2... 6 6 2 eee te th te dir(4) 
format of graphical files. . 2. 2. 2 2. eee ee ee gps(4) 
format of SCCS file: «..-<. 2: mies ws He we, Be sccsfile(4) 
format of system volume. . . 2... 6 2 ee ee ee ew fs(4) 
format specification intext 2... 2 4 ee ee ee ee fspec(4) 
format. syms:common .... 2.2 5 ee ee eee syms(4) 
format tables fornroffor . 2... 1 6 1 ee ew et te tbl(1) 
TOMALIEXG. oes es ey EN we Se nroff(1) 
formats. convert: convert . . 2... 6 6 ee ee es convert(1) 
ROPIIAUS s: «5 =o. ag se i a OR A ae a intro(4) 
formats. utmp, . . - 2 6 6 2 ee ew eh et tw te utmp(4) 
formatted input. . 2... 6 2 2 ee ee ee ee scanf(3S) 
formatted output of avarargsf 6 ww we ee ee vprintf(3S) 
formatted output. printf, . 6. 6 1 ee ee ee ee printf(3S) 
formatted with the MM macros. .. . 1... 2 ee eee mam(1) 
formatting a permuted index. . . . 2. 6... 2 2 eee mptx(5) 
formatting documents, ...... 0. 2. 2 ee ee eee mm(5) 
formatting macros. .. 2... 2. 5 6 ee ee ee ee es ms(5) 
formatting manual pages. . 1. 2... 2 2 ee we eee man(5) 
formatting papers... 6.6 05 6 ese os Se 8 Oe a me(5) 
forms. /generate/modify ...... 2.2.2.2 se ee astgen(1) 
FORTRAN dialect. 2.0.6 6 0 ee ee ee et ee ratfor(1) 
FORTRAN language. ... 1.2. 6 ee eee ee eee efi(1) 
FORTRAN, ratfor, orefl . 2. 6. 6 1 1 ee ee ew tee ww fsplit(1) 
fortune: printarandom, ..... 2. ++ eee eee fortune(6) 
fpgeumask, fpsemaskf . . 2... 2 ee ee ee fpgetround(3) 
fpgetround, fpsetround, ...... 2. ee ee ee fpgetround(3) 
fpgetsticky, fpsetsticky: TEEEF/ .......... fpgetround(3) 
fprintf, sprintf: print . . 2. 2 1 ee ee ee eee printf(3S) 
fpsetmask, fpgetsticky/ . . 2. 26 2 2 ee ee fpgetround(3) 
fpsetround, fpgetmask, .... 2... ee ee ee fpgetround(3) 
fpsetsticky: IEEE floating ...... 2.2.2.2. -. fpgetround(3) 
fputc, putw: put characteror . 1... 1 2 ee ee es putc(3S) 
fputs: putastringona .. 2... 2s 2 ee eee eee puts(3S) 
fread, fwrite: binary 2... 1 1 1 ee ee te te fread(3S) 
frec: recover filesfroma ... 2.1.1 2 ee ee eee frec(1M) 
free a library structure. . 2... 1 ee ee ew ee ee t_free(3n) 
free disk blocks andi-nodes. . 2. 2. 2 1 2 we ee ee df(1M) 
free, realloc, calloc: main... .. 1. 2 eee eee malloc(3C) 
free, realloc, calloc, 1... 6 1 ee ew ee ee es malloc(3X) 
freopen, fdopen: opena . 2... 2 ee ee ee ee es fopen(3S) 
frexp, ldexp, modf: manipulate... .. 2... 2. ea. frexp(3C) 
from a backup tape... 2. 6 2 6 ee ew ee ee ee frec(1M) 
from a common object file. . 2. 2... 6 6 we ee ee list(1) 
from acommon object file. 2... 2.2... 2 ee eee strip(1) 
from a connect request. 2... 1 ee we ew ee t_rcvconnect(3) 
froma. SOCKELTECV, 6 66s 8 we oe Woe ee eS recv(2) 
from a stream. /fgetc, . 2... 6 ee we ew ee we getc(3S) 
from & SUTEAM se 5 Oe ew a ee gets(3S) 
from an object fille. . 2. 2. 1 1 ee eee ee ee mkifile(iM) 
from an SCCS fille. 2. 2... 1 1 ee ee ee ee rmdel(1) 
from argument vector. . . 2. 1. 2 6) we ee ee getopt(3C) 
from disconnect. .. +. 2c eee ee eee ne t_rcvdis(3n) 
from dump. /extract error... 2 2 ee ee ee errdead(I M) 
from /etc/passwd. /and update .........-. pwconv(1M) 
from /etc/passwd. /and update .......... pwunconv(1M) 
PROUT TUES eo 7 te ses Be AE we eS we. See 8 oe Gece read(2) 
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ncheck: generate path names 
nlist: get entries 

acctcms: command summary 
glist: print out file lists 
geipw: gel name 

cclsw, cc2sw, cc2fp: 

gencc: create a 

system volume. 

formatted input. scanf, 

of file systems processed by 
file systems. 

a lost+found directory for 


reposition a file pointer in/ 


text files. 
or efl files. 
Status. 


stat, 

information. statfs, 

identi fier. 

pointer in a/ fseek, rewind, 
communication/ stdipc, 


program. 
Transfer Protocol server. 


/a file for a pattern using 
shutdown: shut down part of a 
advertised resource. 

error/ erf, erfc: error 

gamma: log gamma 

hypot: Euclidean distance 

of a common object file 
matherr: error-handling 

prof: profile within a 

math: math 

intro: introduction to 

jO, jl, jn, yO, yl, yn: Bessel 
password and file encryption 
logarithm, power, square root 
remainder, absolute value 
ocurse: optimized screen 
300, 300s: handle special 
terminals. hp: handle special 
terminal. 450: handle special 
sinh, cosh, tanh: hyperbolic 
atan, atan2: tngonometric 


using a file or file/ 

fread, 

connect accounting records. 
moo: guessing 

back: the 

bj: the 

craps: the 

wump: the 

trk: trekkie 


fromi-numbers. . . 2... 7-7 ee ee ee eee ncheck(1M) 


from name list, 6. oe Be kw OS we eS nlist(3C) 
from per-process accounting/ ........ . acctcms(1M) 
from proto file; set links/ «6. 6 1 ee eee ee ee es qlist(1) 
from-UID: 4. idk oe eo BR es ee eS getpw(3C) 
front-end tothe cccommand. .........++.-. cclsw(1) 
front-end tothe cccommand. ........ . gencc(1M) 
fs: file system: formatof . 2... 6 ee ee ee ee es fs(4) 
fscanf, sscanf: convert 2... 1 1 ee eee ee ee scanf(3S) 
fsck and ncheck. flist . 2. 6 1 1 ee ee ew ee checklist(4) 
fsck, dfsck: check and repair . 2. 1 ee ee ee ees fsck(iM) 
fsck. mklost+found: make ...... +... mklostfnd(1M) 
fsdb: file system debugger. . ~~... 2. + e+ e+ e+ ees fsdb(M) 
fseek, rewind, ftell: . 2... 6... 2 ee eee ee fseek(3S) 
fsize: report file size. 2 2. 6 6 1 ee ee te eee fsize(1) 
fspec: format specification in. . 6 6 1 we ew ew ee fspec(4) 
fsplit: split FORTRAN, ratfor, . 2. 6. 6 6 2 ee ee eee fsplit(1) 
fsstat: report file system. 2. 2 2 ee ee ee ee es fsstat(1M) 
fstab: file-system-table. 2 1 2 1 ee ee ee et et fstab(4) 
fstat: get file status. . 2 © 6 1 ee et ee ee ee stat(2) 
fstatfs: get filesystem . 2... 6 ee ee ee ee ee statfs(2) 
fstyp: determine file system . . 2... 6 2 ee ee ee fstyp(1M) 
ftell: reposition afile . 2... 6 ee ee ee we ee fseek(3S) 
ftok: standard interprocess . . . 1. 1 + es ee wee stdipc(3C) 
ftp: ARPANET file transfer . . 2. 2 6 6 eee ee ee ee ftp(1) 
fipd: DARPA Intemet File . . 1... 2. 22 2 ee ee ftpd(1M) 
fiw: walk afiletree. 2. 1 1 1 1 ee ew ee te we ee ftw(3C) 
full regular expressions. . 2... 1 + ee ee ee eee egrep(1) 
full-duplex connection. «6 6 6 ee eee ee shutdown(2) 
fumount: forced unmount ofan .......... fumount(1M) 
function and complementary... . 2-1 + ee eee erf(3M) 
PUNCION: a Ve. 6B oe ee aE OR er ee gamma(3M) 
MINCHIOR: es eh Gk SE Sis, BO Se ae hypot(3M) 
function. fine numberentries .........444.4. Idlread(3X) 
FURCHIONG: es ho se ee a a Se ee matherr(3M) 
FUNCUGM: - WS: 3, oe. ee we HE BR, So prof(5) 
functions and constants. . . 2... 6 6 ee ee we ew math(5) 
functions and libraries. . . . 1 2 ee ee ee ew te ew intro(3) 
functions. bessél: ck 6 WK ER ROR ee OR bessel(3M) 
functions. Crypt: 6 6 42a we SOR Oe ee ee crypt(3X) 
functions. /sqrt: exponential, . . 2... 1... 2 eee exp(3M) 
functions. /floor, ceiling, . . . 1... 6.2.2 ee eee floor(3M) 
PONCHONS:.. 6.36 se. Seo Boe lsa) a9 Re A aS GO SE a ocurse(3X) 
functions of DASI 300 and 300s/ . 2... 2 1 1 ee ee 300(1) 
functions of Hewlett-Packard ........ 542484806 hp(1) 
functions of the DASI450 . ... 2... 1 1 1 ee ee 450(1) 
FUNCHONS:< oer te es Bo Sie e-Gov sinh(3M) 
functions. flan, asin, acos, . . 1. 1 6 ee ee ee ew trig(3M) 
fusage: disk access profiler, . . . 2. 2. ee we eee fusage(1M) 
fuser: identify processes . . 1. 6. 2 ee ee ee ee fuser(1M) 
fwrite: binary input/output. . 2... 6 ee ee ee fread(3S) 
fwtmp, wtmpfix: mamipulate ..... 2... 2. ee. fwtmp(1M) 
DANG). gods Sk RS a: A, ee ae moo(6) 
game of backgammon. ....- - ee ee we ee eee back(6) 
game of black jack. 3 << 4 ss se oe ae ee we ee bj(6) 
Pam Of Craps. ess Bee Sh we le ee craps(6) 
game of hunt-the-wumpus. . ... 2... 2... + eee wump(6) 
Bames ac 8 ke ta ee ia es SS ee ee sw ee trk(6) 
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intro: introduction to 
gamma: log 

file. 

number to string. ecvt, fcvt, 
tekset, td: graphical device/ 


the cc command. 

maze: 

abort: 

cflow: 

cross-reference. cxref: 
classification and/ chrtbl: 
by user ID. diskusg: 
makekey: 

terminal. ctermid: 

crypt, setkey, encrypt: 
i-numbers. ncheck: 
lexical tasks. lex: 
/srand48, seed48, lcong48: 
and command forms. astgen: 
srand: simple random-number 
gets, fgets: 

get: 

getsockopt, setsockopt: 
ulimit: 

the user. cuserid: 

getc, getchar, fgetc, getw: 
through the/ nisgetcall: 
getdtablesize: 

nlist: 

umask: set and 

Stat, fstat: 

statfs, fstatfs: 

ustat: 

information. sysfs: 


file. 


/setgrent, endgrent, fgetgrent: 
getlogin: 
logname: 

msgget: 

getpw: 

geipeemame: 

system. uname: 

provider. nlsprovider: 

host. getservaddr: 

/senetent, endnetent: 
/sethostent, endhostent: 

getmsg: 

unget: undo a previous 
argument vector. getopt: 
/setpwent, endpwent, fgetpwent: 
working directory. getcwd: 
times. times: 

and/ getpid, getpgrp, getppid: 
/setprotoent, endprotoent: 
information. t_getinfo: 
/geteuid, getgid, getegid: 
getrpcbyname, getrpcbynumber: 


PAINS). x. Sink es, ee a ee ES, ee, a intro(6) 
gamma function. .. 1... 6 2 ee eee ewe gamma(3M) 
gateways: routed configuration... .......-. gateways(4) 
gcvt: convert floating-point ....-.. +. sees ecvt(3C) 
gdev: hpd, erase,hardcopy, ........2-+2+6.2-. gdev(1G) 
ged: graphical editor, 2... 2 1 ee ee ee ee ged(1G) 
gencc: create afront-endto ... 1... 2.1 ee eee gencc(1M) 
RENETAMC AIMEZES 65.5 oh a6 ee es cee aes maze(6) 
generate aSIGABRT. . 2... 1 1 ee ee ee ee abort(3C) 
generate C flowgraph. . . . . 2. 2 2 eet we ew ewe cflow(1) 
generate Cprogram . 1. 7 ee ee ee te te ee cxref(1) 
generate character 2. 0 6 1 6 ee tw we owe tw chribi(iM) 
generate disk accounting data ......-+.e.. diskusg(1M) 
generate encryption key. . 2... 6 1. 1 ee ee we makekey(1) 
generate file name for . 2... 1 ee ee ee ee ctermid(3S) 
generate hashing encryption. ......-+ +. 2.6. crypt(3C) 
generate path names from... 1. 1 1 see we ncheck(1M) 
generate programs forsimple ..........-2588- lex(1) 
generate uniformly distributed/ ........4.. drand48(3C) 
generate/modify ASSISTmenus ........-+.. astgen(1) 
SeNeTator. TONG, <6. oe 8s Wo eS ee a rand(3C) 
get astring fromastream. . . 1... 2 ee ee eee gets(3S) 
get aversion of anSCCSfile. . 2... 2... 2. 2 we eee get(1) 
get and setoptions onf ww ww we ee ee es getsockopt(2) 
get and setuserlimits. ... 1... 1 ee ee wee ulimit(2) 
get character loginnameof ........++246-. cuserid(3S) 
get character or word froma/ ... 2. - 1 ee ee eee getc(3S) 
get client’s data passed . 2... 2.1 ee ee eee nlsgetcall(3n) 
get descriptor table size. . . 2... - 2 72 ees getdtablesize(2) 
get entries from name list. . 2. 1. 1 1 1 ew we nlist(3C) 
get file creation mask. ... 1. 2. ee we ee ww ewe umask(2) 
Per Me Stas: 66 LA, Sh we RE AO stat(2) 
get file system information. . ........-..2e46-, statfs(2) 
get file system statistics, 2. 2. 1 6 1 1 ee eee ee ew ustat(2) 
get file system type . 2.2.2 2 2 ee eee ew we eee sysfs(2) 
get: get aversion of anSCCS .. 1... 11 ee eens get(1) 
get group file entry. . . 2... 6. 2s eee ee we getgrent(3C) 
get login fame. 6: <6. <8 ew a Raw getlogin(3C) 
get loginnmame. . 2... see eee ee ee wee logname(1) 
get message queue. . 2... 1 1 1 eee ee ee msgget{2) 
get name from UID. . . . 2. 2 2 2 ee wee eee ew getpw(3C) 
get name of connected peer. ........6..- getpeemame(2) 
get mame of current CTIX 2... 1 1. wee ee ee uname(2) 
get name oftransportt ... . 1. 2 ee ee eee nlsprovider(3n) 
get network address of service . .....2 66. getservad(1M) 
get NELWOLK ENITY. 606 8 hee ws ee ee Oe ee getnetent(3) 
get network hostentry, ....-...2.56+0586- gethostbyname(3) 
get next message Offastream. . .......-.e6-. getmsg(2) 
get of an SCCS files 6.4 5 a hws ew we wR unget(1) 
get option letter from . . 1. 1 we ee ee ew we getopt(3C) 
get password fileentry, . .. 2... 2... ee ae getpwent(3C) 
get path-name of current... . 1-1. ee eee getcwd(3C) 
get process and child process . . 2... 1. 1 ee wees times(2) 
get process, process group, . . 2 2 6 1 ee ew ee getpid(2) 
Bel PIOLOCOL entry... <i55 oes osc ee A a a getprotoent(3) 
get protocol-specific service .......- 2. t_getinfo(3n) 
get real user, effective user/ . 2... 1. 2 ee ee eee getuid(2) 
get rpcentry. getrpcemt, ...... 2.622. getrpcent(3) 
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getrpcport: 

/setservent, endservent: 
semeet: 

fgetspent, Ickpwdf, ulckpwdf: 
identifier. shmget: 
getsockname: 

t_getstate: 

tly: 

time: 

get character or word from a/ 
character or word from/ getc, 
current working directory. 
entries and put in a file. 

table size. 

getuid, geteuid, getgid, 
environment name. 

real user, effective/ getuid, 
user,/ getuid, geteuid, 
setgrent, endgrent,/ 
endgrent,/ getgrent, 

getgrent, getgrgid, 
sethostent,/ gethostbyname, 
gethostent, sethostent,/ 
gethostbyname, gethostbyaddr, 
unique identifier of current/ 
get/set name of current host. 


stream. 

setnetent,/ getnetent, 
getnetent, getnetbyaddr, 
getnetbyname, setnetent,/ 
argument vector. 


options. getopts, 
command options. 


connected peer. 

process group, and/ getpid, 
process, process group, and/ 
group, and/ getpid, getpgrp, 
getprotoent, getprotobynumber, 
getprotobyname,/ getprotoent, 
getprotobyname, setprotoent,/ 


setpwent, endpwent,/ 
getpwent, getpwuid, 
endpwent getpwent, 

get rpc entry. getrpcent, 
getrpcbynumber: get rpc/ 
number. 

a stream. 

address of service host. 
getservent, getservbyport, 
setservent,/ getservent, 
getservbyname, setservent,/ 
gettimeofday, settimeofday: 
gethostname, sethostname: 
current/ gethostid, sethostid: 


get RPC port number. . . 1... 1 ee . getrpcport(3) 
get serviceentry. . 2. 6 7 ee ee ee . . « getservent(3) 
get setof semaphores. . . 2. 1 2 ee ee ee ees semget(2) 
get shadow. /endspent, ......+.-5 . . getspent(3X) 
get shared memory segment . . . 2... ee ee eee shmget(2) 
get socketname. ..... 2... ees . getsockname(2) 
get the current state. 2 2 2 1 1 2 ee ee ee ee t_getstate(3) 
get the name of the terminal. . . 2... 6 6 ee ee eee tty(1) 
Bet HNC. 6.4: v6 ce Se ew ee Se a a a a time(2) 
getc, getchar, fgetc, getw: 6 6 ee ee ee ee ee getc(3S) 
getchar, fgetc, getw: get 2 6 2 ee ee ee eet ee getc(3S) 
getcwd: get pathname of .. 2... + 2 ee eee getcwd(3C) 
getdents: read directory .. 2... 2 ee eee eee getdents(2) 
getdtablesize: get descriptor... .. +... getdtablesize(2) 
getegid: getrealuserf . 2... 1 ee ee eee eee getuid(2) 
getenv: retum value for . 2. 2. 1. 2 1 ee ew ee es getenv(3C) 
geteuid, getgid, getegid: get. 2. 2. 1 2 ee ee ew eee getuid(2) 
getgid, getegid: getreal . 2. 2 1 1 ee ee we ee ee getuid(2) 
getgrent, getgrgid, getlgmam, .....+ +--+. ees getgrent(3C) 
getgrgid, getgram, setgrent, . 2... 1. + + see getgrent(3C) 
getgmam, setgrent,endgrent/ .. ... + - ewes getgrent(3C) 
gethostbyaddr, gethostent, ......+4... gethostbyname(3) 
gethostbyname, gethostbyaddr, ........ gethostbyname(3) 
gethostent, sethostent,/ . 2... 2. 2 ee ee gethostbyname(3) 
gethostid, sethostid: get/set . . . 2. 2 ee se wees gethostid(2) 
gethostname, sethostname: . .. .. ++ + se gethostname(2) 
getlogin: get loginname. . . . 2... 2 ee ew eee getlogin(3C) 
getmsg: get next message Offa . 2... 1 1 ee wee getmsg(2) 
getinetbyaddr, getnetbyname, ....... . . getnetent(3) 
getnetbyname, setnetent,/ .. 2... 6 1 ee ee ee getnetent(3) 
getnetent, getnetbyaddr, . . .. 1. ee 2 ee ee getnetent(3) 
getopt: get option letterfrom ........-268- getopt(3C) 
getopt: parse command options. ........e+.-. getopt(1) 
getopitcvt: parse command ..... 4+ eee eee getopts(1) 
getopts, getopicvt: parse... ww ee te ee getopts(1) 
getpass: read a password. . 2... + 6 ee wee getpass(3C) 
geipeemame: getnameof  .. . 1. eee ee getpeemame(2) 
getpgrp, getppid: get process, . . 2.6. 2 6 eee eee getpid(2) 
getpid, getpgrp, getppid: get. 2 2 1 we ee ee getpid(2) 
getppid: get process, process . 1... 1 1 ee ew ee ee getpid(2) 
getprotobyname, setprotoent/ ....... . » getprotoent(3) 
getprotobynumber, . 2. 6 2 1 ee ee . « getprotoent(3) 
getprotoent, getprotobynumber, ..... . . « + getprotoent(3) 
getpw: getname from UID. ...........2.-. getpw(3C) 
getpwent, getpwuid, getpwnam, .........-. getpwent(3C) 
getpwnam, setpwent, endpwent/ ......... getpwent(3C) 
getpwuid, getpwnam, setpwent, . . 2... 2. 2. eee getpwent(3C) 
getrpcbyname, getrpcbynumber: .......... getrpcent(3) 
getrpcent, getrpcbyname, ......... . » getrpcent(3) 
getrpcport: gt RPCpon .. 2... 2 ee eee getrpcport(3) 
gets, fgets: getastnng from ..... 2-2. ee eee gets(3S) 
getservaddr: get network ... 1... + ee eae getservad(1M) 
getservbyname, setservent/ ......- eee getservent(3) 
getservbyport, getservbyname, .........-. getservent(3) 
getservent, getservbyport, ..... 2 6 e+ ee ee getservent(3) 
get/setdate andtime. ........-+.-244.-. gettimeofday(2) 
get/set name of currenthost. .......... gethostname(2) 
get/set unique identifierof ........ . . gethostid(2) 
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and set options on sockets. 
endspent, fgetspent, lckpwdf,/ 
fgetspent, lckpwdf,/ getspent, 
get/set date and time. 

and terminal settings used by 
modes, speed, and line/ 

ct: spawn 

settings used by getty. 
getegid: get real user,/ 
pututline, setutent/ getut: 
setutent,/ getut: getutent, 
getut: getutent, getutid, 

from a/ getc, getchar, fgetc, 
common CTIX system terms and/ 
ascfime, ctime, localtime, 
fish: play 

setymp, longymp: non-local 
string, format of graphical/ 
graph: draw a 

sag: system activity 
commands. graphics: access 
network useful with 

/erase, hardcopy, tekset, td: 
ged: 

primitive string, format of 
toc: dtoc, ttoc, vtoc: 

gutil: 

numerical commands. 

tplot: 

plot: 

subroutines. plot: 

mvt: typeset documents, view 
package for typesetting view 


pattern. 
fuser, effective user, real 


/getppid: get process, process 
chown, chgrp: change owner or 
endgrent, fgetgrent: get 
group: 

setpgrp: set process 

id: print user and 

real group, and effective 
setuid, setgid: set user and 
Remote File Sharing user and 
newgrp: log in to a new 
chown: change owner and 

a signal to a process or a 
update, and regenerate 
checkers. pwck, 

ssignal, 

install or relocate a PT or 
download. tdl, 

hangman: 

moo: 


for Interphase V/TAPE 3200 


getsockname: get socketname. ......... getsockname(2) 
getsockopt, setsockopt: get 6 6 1 we wee es getsockopt(2) 
getspent, getspnam, setspent, ..........--. getspent(3X) 
getspnam, setspent, endspent, . 2... . 6. ee ee getspent(3X) 
gettimeofday, settimeofday: .......-+-.. gettimeofday(2) 
getty. gettydefs: speed 2. 2... 1 1 we ee ee gettydefs(4) 
getly: setterminal type, .........+.0.. getty(1M) 
getty toaremoteterminal. . .. 2... 2... 6 2 ee eee ct(1C) 
gettydefs: speed andterminal ..........., gettydefs(4) 
getuid, geteuid, getgid, ... 1... 2... 5-2 eee getuid(2) 
gelutent, getutid, getutline, 2... 2 2 ee ee eee gemi(3C) 
getutid, getutline, pututline, . ... .. 2... eee gewt(3C) 
getutline, pututlme/ 2. 2 2 1. 1 ee ee et ee gemt(3C) 
getw: get character orword . . 2. 2 2 2 ee ee ews getc(3S) 
glossary: definitions of .......4.4..+.+.-6-. glossary(1) 
gmtime, asctime, cftime, . .... 2.4. +2. 2 ee ae cuume(3C) 
PAHO EASED «ce las es gs Ge aS: vo SP > SY SO, Oe ES we ae fish(6) 
DONO. 5 oe Soe os ae ae ew ee ee he ee ee seymp(3C) 
gps: graphical primitive .. 1.6 1 6 eee ee ee gps(4) 
POTN: ° Beas iB od See cae Ws OS Gey Se, Bt ee, csp graph(1G) 
STAD. ese Ge oreo Se: BS a SG ES. SS sag(1G) 
graphical and numerical . . 2... 2... +e ee graphics(1G) 
graphical commands. ... 2... 1. ee ee eee stat(1G) 
graphical device routines and/ . 2. 1... ee eee gdev(1G) 
gfaphical Cdr <6 698 Sok So we ES Se ee ged(1G) 
graphical files. /graphical 2. 1. 1 1 ee ee ee we ee gps(4) 
graphical table of contents/ . . . 2. 7 2 ee ee ee toc(1G) 
graphical utilities. 2 2... 6 eee ee eh et eh gutil(1G) 
graphics: access graphical and .......2..-.- graphics(1G) 
Sraplics MNCS: 2 ones. a Se eS Ae Oe es tplot(1G) 
graphics interface. . 2... 1.5. 6 se ee es wee wens plot(4) 
graphics:interface 4. 6. whe A plou(3.X) 
graphs, and slides. mmt, . . 1 1. 1 2 2 ee ee ees mmt(1) 
graphs and slides. fmacro . . 2. 1 1 wee ee ee mv(5) 
greek: select terminal filter. . . 2... 1. 22 ee we ee greek(1) 
grep: searchafilefora . . 2... 2 1 eee eee eae grep(1) 
group, and effective group. ww 1 1 we ee ee getuid(2) 
group, and parent process IDs. . .....-..-4468. getpid(2) 
QYOUDs <i: Seth Scve eee, Sas ce, Se EH es 8, ee a wk chown(1) 
group file entry. /setgrent, ......-...+.2445-4 getgrent(3C) 
QTOUD Mle ss-g: ene eed OC Ee wo Se ae group(4) 
STOUT: | vss cas ie. ad Spe Hay He LW ie SS setpgrp(2) 
group IDs andnames. .....-. 2.566. 6 ee ewes id(1M) 
group IDs. /effective user, . . . 1... +2 ee wee getuid(2) 
group IDs. so. 4: 66s So es GE Ew Se Ss setuid(2) 
group mapping. idload: .. . 1... 1 ee ee eee idload(1M) 
SOUP; he. ao SS Ne Ge ce eS newgrp(1M) 
group Of a file: 2. o.6.5: oes ar es we eh Sve wm Be G8 chown(2) 
group of processes. /send  . «1 we ee we ee te es kill(2) 
groups of programs. /maintain, ......... ee. make(1) 
grpck: password/group file .... 2... + eee. pwcek(1M) 
gsignal: software signals. . . .. 2... 2. es ee ee ssignal(3C) 
GT local printer. fmvtpy: . 2... 6 ee ee ee mktpy(1) 
gidl, ptdl: RS-232terminal . © 2 2 2 2 1 we ee eee tdl(1) 
guess the word. . 2. 2 2 2 1 ee ew we we ee es hangman(6) 
guessing game. «0 2 2 we tt tt tet te tt tt moo(6) 
gutil: graphical utilities, . 2... 2. ewe eee gutil(1G) 
half-inch tape controller. 2... 6-1 ee ee ee ee ee ipt(7) 
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stape: SCSI quarter-inch and 
system state. shutdown, 

DASI 300 and 300s/ 300, 300s: 
Hewlett-Packard/ hp: 

the DASI 450 terminal. 450: 
varargs: 

curses: terminal screen 
setchrclass: character 


nohup: run a command immune to 
graphical/ gdev: hpd, erase, 
hinv: 

hcreate, hdestroy: manage 
spell, hashmake, spellin, 
setkey, encrypt: generate 

find spelling errors. spell, 
search tables. hsearch, 

dump. 

tables. hsearch, hcreate, 

file. scnhdr: section 

files. filehdr: file 

hmits: file 

unistd: file 

file. Idfhread: read the file 
/seek to the optional file 

/read an indexed/named section 
Idahread: read the archive 
helpadm: make changes to the 
help: CTIX system 


Help Facility database. 
tape file archiver. hpio: 
/nandle special functions of 
dump. hd: 


libdev: manipulate Volume 
fortune: print a random, 
/ntohs: convert values between 
endhostent: get network 
unique identifier of current 
get/set name of current 

get network address of service 
/set or print the Internet 
change Remote File Sharing 
rwhod: 

or print identifier of current 
identifier of current host/ 
Internet host name of the/ 
packets to network 

of Hewlett-Packard terminals. 
1d: graphical device/ gdev: 
terminal tape file archiver. 
manage hash search tables. 
convert values between host/ 
values between host/ htonl, 
wump: the game of 

sinh, cosh, tanh: 

hyphen: find 


half-inch tape. 2 2 2 6 ee ee ee ee eee ee stape(7) 


halt: shut down system, change ........-. shutdown(1M) 
handle special functions of . «1 1 1 ee ee ee eee 30Q1) 
handle special functions of . . 2 6 2-1 ee eee es hp(1) 
handle special functions of «6 2. ee eee ee eee 450(1) 
handle variable argument list. . . . . 1... + 6 2 2 es varargs(5) 
handling and optimizationf ......-. ++ see curses(3X) 
handling. /_tolower,_toupper, ... 2... s+ 2... ctype(3C) 
hangman: guess the word. . . .. - ee + ss eee hangman(6) 
hangups and quits. 2. 1. 6 6 ee eee et ee es nohup(1) 
hardcopy, tekset,td: 2. 6 ee ee ee ee eee gdev(1G) 
hardware inventory, . . . 6) ee ee ee ee hinv(1M) 
hash search tables. hsearch, . . . - . 2 + ee eee hsearch(3C) 
hashcheck: find spelling/ .... -- 2 ee ee eee speli(1) 
hashing encryption. crypt, . - - - 6 / + ee ewes crypt(3C) 
hashmake, spellin, hashcheck: . . . 6. + +e ee ee spell(1) 
hcreate, hdestroy: manage hash. ww we ee ee hsearch(3C) 
hd: hexadecimal and ascii file . . . ...- - 2. ew wes hd(1) 
hdestroy: manage hash search. . 2 1 we se ee ee hsearch(3C) 
header foracommon object... .. + s+ s+ s+ + ea» scnhdr(4) 
header forcommon object... 6. 6 1 6 ee ew ee es filehdr(4) 
headerfotl <6 ieee i a me Ha ae ete ee Se ae limits(4) 
header for symbolic constants. . . . 6. + ee ee es unistd(4) 
header of acommon object . 1... ee ee ee Idfhread(3X) 
header of acommon objeci{  . 6. 1. we ee ee Idohseek (3X) 
header of acommon objectf/  . «1 1 1 we et ee Idshread(3X) 
header of amemberofanf .......++ 66. ldahread(3X) 
Help Facility database. . . 1... ee ee eee helpadm(1M) 
Helo Facility: ¢- 6. 26 oe gs eS Se gs ewe ws Ae GN help(1) 
help: CTIX system Help Facility. . 2... 6. 6s se ees help(1) 
helpadm: make changes tothe ......+...-. helpadm(1 M) 
Hewlett-Packard 2645A terminal . . 2... 2. ee wae hpio(1) 
Hewlett-Packard terminals. 2... 2 6 2 6 ee eee eee hp(1) 
hexadecimal and ascii file ........+ 66.268. hd(1) 
hinv: hardware inventory. . --.....2.4. +4. hinv(1M) 
Home Blocks (VHB). . . 2. 1. 2. 6 ee ee ee ee libdev(3X) 
hopefully interesting, adage. . 2... 2. + ee ees fortune(6) 
host and network byte order, . . 1... + eee. byteorder(3) 
host entry. /sethostent, .... 2... ee ee gethostbyname(3) 
host. /sethostid: get/set . 2... ee ewe ee ee gethostid(2) 
host. /sethostname: .... 1... 2 ew eee . gethostname(2) 
host. getservaddr: . 2... 2. 1 1. 7 ee eee getservad(1M) 
host name of the current{/ ..... 5... + we eee hostname(1) 
host password. rfpasswd: . . 2 2. 6 ee ee ee rfpasswd(1M) 
host status server, . 1. we ew ee we ee ee rwhod(1M) 
host system. hostid: sett... 1 6 1. eee ee ee ee hostid(1) 
hostid: setorprimt . 66 2 ss ee eet te ew es hostid(1) 
hostname: setorprintthe ........+-+..-. hostname(1 ) 
hosts. /eend ICMP ECHO_REQUEST ......... ping(1M) 
hp: handle special functions . . . 2... - ee ew eee hp(i) 
hpd, erase, hardcopy, tekset, . . 1. 2... + ee eee. gdev(1G) 
hpio: Hewlett-Packard 2645A ......6+6+4 524080. - hpio(1) 
hsearch, hcreate, hdestroy: ..... 1. ee ee hsearch(3C) 
htonl, htons, ntohl, ntohs: . . . . 6... ee eee byteorder(3) 
htons, ntohl, ntohs: convert... ....-+ ese byteorder(3) 
hunt-the-wumpus. 2... 26 6 ee ee ee ee ee wump(6) 
hyperbolic functions. . 2 2. 2 eee ee ee te sinh(3M) 
hyphenated words. . 2... 6 1 ete ew ee we ee hyphen(1) 
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function. 

network hosts. ping: send 
Protocol. 

disk accounting data by user 
semaphore set or shared memory 
and names. 

setpgrp: set process group 

issue: Issue 

fstyp: determine file system 

/sethostid: get/set unique 

system. hostid: set or print 

get shared memory segment 
using keywords. locate: 

file or file/ fuser: 

what: 

user and group mapping. 

id: print user and group 

group, and parent process 

group, and effective group 

setgid: set user and group 
/fpgetsticky, fpsetsticky: 

interface parameters. 

mkifile: make an 

core: format of core 

format of curses screen 

crash: examine system 

nohup: run a command 

limits: file header for 

C language preprocessor 

finc: fast 

dirent: file system 

Agoto, tputs: terminal 

for formatting a permuted 

of a/ Idtbindex: compute the 

: permuted 

a common/ Idtbread: read an 

Idshread, Idnshread: read an 

Idsseek, ldnsseek: seek to an 

receipt of an orderly release 

receive a unit data error 

family. 

inet_ntoa, inet_makeaddr,/ 

*‘super-server’’, 

configuration file for 

for inetd (intemet/ 
Anet_ntoa, inet_makeaddr, 
/net_net work, inet_ntoa, 
Anet_makeaddr, inet_Inaof, 
inet_makeaddr, inet_addr, 
inet_addr, inet_network, 
terminfo descriptions. 

inittab: script for the 
initialization. 

init, telinit: process control 

/drvload, powerfail: system 
terminfo database. tput: 
volume. iv: 

socket. connect: 


hypot: Euclidean distance... . 1. 1. ee eee hypot(3M) 
ICMP ECHO_REQUEST packets to . 2. 2... 2 ee. ping(1M) 
icmp: Internet Control Message... 2... 1 ee eee icmp(7) 
ID. diskusg: generate... ..- 2. eee eee diskusg(1M) 
ID. fremove a message queue,  . . . 2. 2 ee ee iperm(1) 
id: print user and groupIDs .......-. +--+. + id(IM) 
De ses 6k se A a: Esk le lee es TE He setpgrp(2) 
identification fille. 2... 1.6. 6 ee ewe we ee ees issue(4) 
ACM TIEL. © Sena: ee ee Ba We AR Bh OD, SO fstyp(1M) 
identifier of current host. . . 1... 2.242 286-8 gethostid(2) 
identifier of current host . 2. ..0.0.0.-2. 0008268. hostid(1) 
identifier. shmget: . 2. 2... we ee ee ew we ew shmget(2) 
identify a CTIX system command ........4..-. locate(1) 
identify processes using a... 2 ee ee ee ee ee fuser(1M) 
identify SCCS files. 2... 1 1 we ew te ee we we what(1) 
idload: Remote File Sharing .....-....-4.. idload(1M) 
TD s'anid ae. ec ceo: a. i ee we ee Sw SS id(1M) 
IDs. /get process, process. 1 we ee ee et es getpid(2) 
IDs. /effective user,real . 2 2 1 ew we ew te we wt getuid(2) 
TESS SOtI 556, notes tee OR RE A, Bw a a om, Se 4 setuid(2) 
IEEE floating pointf/  . 2. 7 ee ee ee ee es fpgetround(3) 
ifconfig: configure network ......-- -- =: =; . ifoonfig(1M) 
ifile from an object fille. . 2... 6 2 ee ee ee mkifile(1 M) 
[mage Giles 5 6 36 sek eR oe oe Oe SR ee core(4) 
image file. scr_dump: . . 2... 6 ee ee eee scr_dump(4) 
MNSBOS) 2-694: ws GS: Se ep as a crash(1M) 
immune to hangups and quits. ........6+86-. nohup(1) 
implementation-speci ficf 6 6 6 ew ewe ee ee limits(4) 
include files. /determine . . 1... 2. 2 se ew eae includes(1) 
incremental backup. . . 2... e+ 2 eee ee eee finc( 1M) 
independent directory entry, . . 2... 1 ee ee ee dirent(4) 
independent operations. . . .. - 2 ees ee ee otermcap(3X) 
index. fhe macro package... 2... ee eee eee mptx(5) 
index of asymboltable entry ........4.2. idtbindex(3X) 
MOORS. 03.66 Se 8s GS Se SE ee eee Ee eS 1 BE ptx(1) 
indexed symbol table entryof ........... Idtbread(3X) 
indexed/named section headerf/ ........46. Idshread(3X) 
indexed/named section ofa/ .. . 1... 2 ee ee Idsseek(3X) 
indication. /facknowledge ........4-. ea ee t_revre]l(3n) 
indication. t_rcvuderr; .......4.6+ 8068-8 t_rcvuderr(3) 
inet: Intemet protocol .. 1... 6 6 ee + +s ee s inet(7) 
inet_addr, inet_network, . . 2.5... 6.5056 2 we eee inet(3) 
inetd: intemet  . . 1 we wee te tt ee et inetd(1 M) 
inetd (intemet/ inetd.conf: ........+..-- inetd.conf(4) 
inetd.conf: configuration fille .......2.4.4.. inetd.conf(4) 
inet_Inaof, inet_netof:/ . . 2... 1. 1 1 ee ee ewe inet(3) 
inet_makeaddr, inet_Inaof/ 2 2. 1 1 1 we ee et es inet(3) 
inet_netof: Intemet address/ 2. 1 1 6 we ee tt te inet(3) 
inet_network, inet_ntoa, . . . 2.6 ee ee ee eee inet(3) 
inet_ntoa, inet_makeaddrJ wg ww ww we ee tt inet(3) 
infocmp: compare or printout .......... infocmp( 1M) 
ANTE DIOCESE: oes sir. is. eS ns Je eae Se ES a Ge ee SS inittab(4) 
init, telinit: process control dn gp ioe ie Gee a aS we eG init(1M) 
initialization. 9. 66 ee a ew ae ee init(1M) 
initialization procedures. . . . 2 2 1 ee we ee eee bre(1M) 
initialize aterminal orquery .. 2... 2... eee eae tput(1) 
initialize and maintain ....... nigh aa tae apis eee iv(1) 
initiate aconnectionona .. 1... 6. 2 ee ee es connect(2) 
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t_sndrel: 

process. popen, pclose: 
process. 

cln: clear 

inode: format of an 

number of free disk blocks and 
start and stop terminal 

sscanf: convert formatted 
push character back into 
fread, fwrite: binary 

poll: STREAMS 

stdio: standard buffered 
fileno: stream status 

uustal: uucp status 

with information from/ pwconv: 
with information/ pwunconv: 
using the mkfs(1)/ qinstall: 
install: 

directories. cpset: 

local printer. mktpy, mvtpy: 
cunstall: 

abs: return 

[6Aa: convert between long 
sputl, sgetl: access long 

atol, atoi: convert string to 
3-byte integers and long 
beopy: 

system. mailx: 

pmint a random, hopefully 
tset: set terminal, terminal 
module. timod: Transport 
err: error-logging 

V/TAPE 3200 half-inch/ ipt: 
qic: 

lo: software loopback network 
Ip: parallel printer 

mem, kmem: system memory 
ifconfig: configure network 
plot: graphics 

STREAMS/ tirdwr: Transport 
‘Transport Interface read/write 
plot: graphics 

swap: swap administrative 
termio: general terminal 


tiop: terminal accelerator 1 


logging and event/ log: 
telnet: user 

protocol. tftp: user 

tty: controlling terminal 
vme: VME bus 

detach serial lines as network 
Anet_Inaof, inet_netof: 
Protocol. icmp: 

named: 
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In, mv: copy, link, ormove 2... ee ee ee ee ee es cp(1) 
lo: software loopback network . . 1. 6 6 6 ee ee eee lo(7) 
load EEPROM. .. 2... ee ee et te ws ideeprom(1M) 
load socket configuration, 2 6. 6 6 2 ee ee ee es slink(1) 
load symbols inkernel . . 2. 2 es ee eee mkdbsym(iM) 
loadable device drivers. 2... 6 6 ee ee st we ews drivers(7) 
loadable drivers. 2. 0 6 6 ee ee ew ee te et Iddrv(1M) 
localtime, gmtime, asctime, . . . 6 2 1s ee eee ctime(3C) 
locate aterminal touseas . ......-+.- - =: - - conlacate(1M) 
locate executable file for 2... 6 6 1 ee ee ee ee path(1) 
locate: identify aCTIX system .... 6+ e+ + sees locate(i) 
locations inprogram. . 2... + 2 ee ee eh ee ene end(3C) 
lock process, text, ordalamn «we ee eee ee es plock(2) 
lockf: record locking on. ww ew ee eee te lockf(3C) 
locking: exclusive accesstO. ww 1 we ee ew te es locking(2) 
locking onfiles. . . 2.2. 2 1 ee ee er ee rene lockf(3C) 
log gamma function. . . 2. 1 6 ee ee te ee gamma(3M) 
log into anew group. . 2... + ee ee ee ee newgrp(1M) 
log: interface to STREAMS .. 1... eee eee ee log(7) 
log, logl0, pow, sqrt: 6 6 1 1 ee ee te ee te ls exp(3M) 
log of failed login attempts. .. . . 1. + ee 2 ees loginlog(4) 
log10, pow, sqrt: exponential, ....-. eee eee exp(3M) 
logarithm, power, square rootf «ww we ee ee ee exp(3M) 
logged Errors: i.e woke ak Se a a we Se Re errpt(1M) 
logged in on local network. . . 1 2. 6 6 eee ew ee ee rwho(1) 
logger cleanup program. . . 1... + + ee eee strclean(1M) 
logger daemon, «ss ss st ee tee ew strerr(1M) 
logging and event tracing. ........-+ ++: +: + log(/) 
login attempts. . 2... 1 1 ee ee we ew te ew loginlog(4) 
login file forremote . 2... 1 1 ee ee ee ee netrc(4) 
1OBIN Nae. S836 eae a AD LE getlogin(3C) 
logit NAMES: fel. <G: S Se SSE AE Oe logname(1) 
login name ofthe user. . 2... 2... ee ee eee cuserid(3S) 
login name of user. . 2... ee 1 ee ee ee logname(3X) 
login password. . 2. 1 6 ee ee ee ee ee ee passwd(1) 
LORI pe ees ee ee a A Aeao es & Sida 5 rlogin(1) 
lopin “Server: 5% 6) heh ee ee Ae wee Ss rlogind(iM) 
lOgIN: Sig Os: 6-4. RAS ee a Ne a hs ck 8 login(1) 
login time. cprofile: setting . . . 2... 2. ee ees cprofile(4) 
login time. profile: . . 2... 1 2 2 1 ee ee ew ee profile(4) 
logname: get loginname. ......- ++ se ees logname(t) 
logname: retum login name of  . . . 1. 2 ee es logname(3X) 
long integer and base-64 ASCI/ .... 2... 2... a641(3C) 
long integer datainaf «2... ee ee ee te eee sputl(3X) 
long integers. fltol3: convert... 2. 6. ee eee 13tal(3C) 
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output device. fold: fold 
setjmp, 

finger: user information 
lo: software 

for an object library. 
mklost+found: make a 
nice: run a command at 
send/cancel requests to an 
interface. 

disable: enable/disable 
reject: allow or prevent 
|pshut, lpmove: start/stop the 
Ipadmin: configure the 
\pstat: print 

spooling system. 
scheduler/ ipsched, Ipshut, 


start/stop the LP scheduler/ 
printer options. 

LP scheduler and/ Ipsched, 
information. 

jrand48/ drand48, erand48, 
directory. 

and update. 

pointer. 

integers and long/ 13tol, 


mega, unixpc,. 

values: 

/access long integer data in a 
permuted index. mptx: the 
documents. mm: the MM 
view graphs and/ mv: a troff 
m4: 

pages. man: 

me: 

formatted with the MM 

ms: text formatting 

‘rebuild the data base for the 
users or read mail. 
sendmail: 

processing system. 

malloc, free, realloc, calloc: 
/mallopt, mallinfo: fast 
regenerate groups of/ make: 
iv: initialize and 

ar: archive and library 
SCCS file. delta: 

mkdir: 

or ordinary file. mknod: 


for fsck. mklost+found: 
mktemp: 

file. mkifile: 

Facility database. helpadm: 
mkdir, mkdirs: 

system. voloopy: 


regenerate groups of/ 
mkhosts: 


long lines for finite width 2... 6 1. 1 eee ee ee fold(1) 
longjmp: non-local goto. =... 66 1 ee ee eee setymp(3C) 
lookup program. . 2. 6 1. 6 2 ee ee eee ee es finger(1) 
loopback network interface. 2... 2. 2 2 2 1 ee ee ee lo(7) 
lorder: find ordering relation .......-+.-268.0-. lorder(1) 
lost+found directory forfsck. . . . 2. . . eee. mklostfnd(1M) 
LOW prionty, ee 66. Se Re a a we nice(1) 
LP line printer. Ip,cancel: 2. 2 ww ee eee ee ew Ip{t) 
Ip: parallel pnnter 2... 2 1 ee ee ee et ee te Ip(7) 
LP printers: enable;, <.<s: 3°68 6G eo we © we eS enable(1) 
LP requests. accept, . 6. 2 6 ee ee ee ee accept(1M) 
LP scheduler and move/ ... 2... e+ eee we Ipsched(1M) 
LP spooling system. .. 2... 6 6 2 eee eee lpadmin(1M) 
LP status information. . .... 2... + ee ee eee Ipstat(1) 
Ipadmin: configurethe LP ...........-.- Ipadmin(1M) 
lpmove: stari/stopthe LP . 2. 2 6 we ee ee ee Ipsched(1M) 
Ipr: line printer spooler, 2... 1 2 ee ee ee th ew ee Ipr(1) 
Ipsched, Ipshut, lpmove: 2... 6 2 ee ee ee ipsched(1M) 
Ipset: set parallel ime «2. 1 1 ee ee ee te Ipset(1M) 
Ipshut, lpmove: start/stop the .......-..-. Ipsched(1M) 
Ipstat: print LPstatus 2... 1 6 1 ee ee ee ee Ipstat(1) 
lrand48, nrand4R mrand4Q, 2. 1 1... ee drand48GC) 
Is: list contents OF eo 6s we See? SS SS ee 1s(1) 
Isearch, Ifind: linear search «ww ww ee et tw Isearch(3C) 
Iseek: move read/write fle . .... 2. 2 eee we eee lseek(2) 
ltol3: convert between 3-byte 6 ww ww ee et 13t01(3C) 
m4: macro processor, 2. 1 6 ee ee te tee ee m4(1) 
machid: mc68k, miti, mini, . . ... 2. 2. 1 ee ees machid(1) 
machine- dependent values. . . 2... - eee we ee values(5) 
machine-independent fashion. . . . 2. - 1. ee eee sputl(3X) 
macro package forformattinga .........244.64.-. mptx(5) 
macro package forformatting .......6..2-e+8-s mm(5) 
macro package fortypesetting ......+.4.+ee- mv(5) 
macro processor, 2. 2 2 2 ee ew ee ee te ww m4(1) 
macros for formatting manual ... . 1... 1 ee eee man(5) 
macros for formatting papers. . 2... 1 6 ee we ew me(5) 
macros. /print/check documents ..........08. mm(1) 
TYARCTOS «55a yo Ri ts a et BO ae, He, @ vas “OLAS ms(5) 
mail aliases file. 2... 1. 1 wee ew we eens newaliases(1) 
mail, mail: send mailto... 1 1 ee ee ee te mail(1) 
mail routing program. ... . 2.5 + see eee sendmail(iM) 
mailx: interactive message .....-..-6+ 2 ees mailx(1) 
main memory allocator, . ......-5656-+6 5288 malloc(3C) 
main memory allocator. . .. 1. 1.6 6 2 + se we eee malloc(3X) 
maintain, update, and 2. 1. 1 1 ee we et ee make(1) 
maintain volume. ..... + 6 6s e+ ee ee we ew ew iv(1) 
maintainer for portable/ . 2... 1 1 1 ww ee et ee ar(1) 
make a delta (change) toan .. 2... 1. ee ee eee delta(1) 
make a directory. . 2 2 1 6 ee ee te we ee ee es mkdir(2) 
make a directory, oraspecial . .......2..4.., mknod(2) 
make a lost+found directory .......44.., mklostfnd(1M) 
make aunigue filename. ...... 2... 2 ees mktemp(3C) 
make an ifile from an object . 2... 6 ee eee mkifile(1M) 
make changestothe Help ..........4.. helpadm(1M) 
make directories. . 2... 1 se ew ew a a mkdir(1) 
make literal copy of file 2... ........6.4.. volcopy(1M) 
make: maintain, update, and . 2... 1 1 ee ee ee make(1) 
make node name commands. .......+4-.-. mkhosts(1M) 
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banner: make posters. ©. 2 6 6 6 6 ee ee ee ee ee es banner(1) 

session. scnipt: make typescript ofterminmal . . . 1 1 ww ee ee ee script(1) 

key. makekey: generate encryption .......+-+++-- makekey(1) 

/realloc, calloc, mallopt, mallinfo: fast main memory/ ........ +++ > malloc(3X) 
main memory allocator. malloc, free, realloc, calloc: ........ . malloc(3C) 
mallopt, mallinfo: fast main/ malloc, free,realloc, calloc, . . 2... 1. 2. ee ee malloc(3X) 
malloc, free, realloc, calloc, mallopt, mallinfo: fastmainf . ....... 2.44. malioc(3X) 
manual pages. man: macros forformatting .....-. +--+ eee: man(5) 

Afind, tdelete, twalk: manage binary searchtrees. . 2... 2 2 5 2 2 ee tsearch(3C) 
hsearch, hcreate, hdestroy: manage hash search tables. . . . 1. - ee 2 ees hsearch(3C) 
Iddrv: manage loadable drivers. . . 2. 2. 2 2 ee ee eee Iddrv(1M) 

unnotify, evwait, evnowait: manage notifications. nmouify, . 2... 6. 6 ee eee notify(2) 
endpoint. t_optmgmt: manage options foratransport . .....-...- t_optmgmt(3n) 
passmgmt: password files management. . . 2. 2 6 ee ee ee et ew ee passmgmt(1M) 
window: window management primitives. . . 2... 6 se ee eee window(7) 

sigignore, sigpause: signal management. /sigrelse, . .. .- - + 2+ 2 ee ees sigset(2) 
wm: window management. ... 1... 6 6 ee ee ee ee ewes wm(1) 

sh]: shell layer mamager, . . 2. 1. 6 - ee ee we ee ee ew we ee es shl(1) 

records. fwtmp, wtmpfix: manipulate connect accounting .......++-6-. fwtmp(1M) 

of/ Idlread, Idlinit, Idlitem: manipulate line numberentries .......--+-- Idlread(3X) 
frexp, lIdexp, modf: manipulate parts of/ . . 1 6 6 6 ee ee ee ee ee frexp(3C) 

comment section. mcs: manipulate the object fle 2... 2 6 2 6 ee ee ew ew ee mesh) 
route: manually manipulate the routing tables. . . . . 1... 2 + ee route(1M) 

(VHB). libdev: manipulate Volume Home Blocks ..........- libdev(3X) 

Anet_netof: Intemet address manipulation routines. . 2. 2... 2 ee ee ee ee ew inet(3) 
man: macros for formatting manual pages. . . - - 2 6 2 ee ee ee ee ee ee man(5) 
routing tables. route: manually manipulate the . . 2... 2. + - + ee es route(1M) 
terminal input and/ rsterm: manually start and slop... . 1.6 e+ se ees . . rsterm(1M) 
ascii: map of ASCII character set. . . 2 2 2 ee ee ee ee ascii(5) 

port to RPC program number mapper. portmap: DARPA .......-..-+5-s portmap(1M) 
File Sharing user and group mapping. idload: Remote ........+ 2.2.4.6. idload(1M) 
scsimap: set mappings forSCSI devices. . . 2... 1. 2 ee eee scsimap(1M) 

files. diffmk: mark differences between... 1. - 2 + 2 2 ee wae diffmk(1) 

umask: set file-creation mode mask. . . 2... 6 6 0 0 ee ee ee te ee ee umask(1) 
set and get file creation mask. umask: . . 2. 6 1 6 ee we eee ee es umask(2) 

table. master: master device information . . . . 2... 1. 6 ee ee master(4) 

masterupd: update the masterfile, 2. 6 6 ee ee ee ee ee ee mastemmpd(1M) 

File Sharing name server master file. rfmaster: Remote . .....-. 2. + ees rfmaster(4) 
information table. master: masterdevice . . 1... 1 ee ee ee te master(4) 

file. masterupd: update the master... 2... 2. es masterupd(1M) 

regular expression compile and match routines. regexp: . . ee ee eee ee ee + egexp(S) 
math: math functions and constants. .......- +288. math(S) 

constants. math: math functions and... . . 1.2 eee 2 ee ee math(S) 

eqn, neqn, checkeq: format mathematical text fornrofforf/ . 2... 1 2 ee ee eqn(1) 
function. matherr: error-handling ........4.645 +6684 matherr(3M) 

maze: generate €@ MAZe. . 2 se ee tt tt tt tt th wh we maze(6) 

unixpc,, machid: mc68k, miti, mini, mega, . . 2. 2 6 ee ee ee machid(1) 

file comment section. mcs: manipulate the object «ww ww eee ee mces(1) 
machid: mc68k, miti, mini, mega,unixpc, 2. 1 6 ee ee ee ee ee ee machid(1) 
interface. mem,kmem: system memory ........4 +4566. mem(7) 

memcpy, memset:/ memory: memccpy,memchr,mememp, ........ ++. memory(3C) 
memset:/ memory: memccpy, memchr,mememp, memcpy, ...... ++ «ss memory(3C) 
memory: memccpy, memchr, memcmp, memcpy, memset: memory/ .......- memory(3C) 
/memccpy, memchr, memcmp, memcpy, memset: memory/ ... .. - + se ees memory(3C) 
free, realloc, calloc: main memory allocator. malloc, ....... + +» eee. malloc(3C) 
mallopt, mallinfo: fast main memory allocator. /calloc, . . . 2... - ee ee ee malloc(3X) 
shmctl: shared memory control operations. . 2... 6 2 ee ee eee shmctl(2) 

queue, semaphore set or shared memory ID. /remove amessage . 2. 6 6 we ee ee iperm(1) 
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Lo a pec i, 


mem, kmem: system 
memcmp, memcpy, memset:/ 
memecmp, memcpy, memset: 
shmop: shared 

lock process, text, or data in 
shmget: get shared 

/memchr, memcmp, memcpy, 
astgen: generate/modify ASSIST 
sort: sort and/or 

files. acctmerg: 

files or subsequent/ paste: 


msgctl: 

recv, recvfrom: receive a 
send listener service request 
getmsg: get next 

putmsg: send a 

msgop: 

mailx: interactive 

icmp: Internet Control 
msgget: get 

or shared/ ipcrm: remove a 
t_error: produce error 

send, sendto: send a 

mesg: permit or deny 
sys_nerr: system error 
strace: print STREAMS trace 
machid: mc68k, miti, 
driver. clone: open any 
machid: mc68k, 

kernel debugger. 


directories. 


/and venfy software using the 
commands. 

object file. 

lost+found directory for/ 


special or ordinary file. 
library. 

name. 

relocate a PT or GT local/ 
documents formatted with the/ 
formatting documents. mm: the 
documents formatted with the 
formatting documents. 

view graphs, and slides. 

table. 

chmod: change 

umask: set file-creation 
chmod: change 

getty: set terminal type, 
uugetty: set terminal type, 

bs: a compiler/interpreter for 
floating-point/ frexp, Idexp, 
touch: update access and 
utime: set file access and 


memory interface. . . 6. 1 2 6 ee ew ee eee ta mem(7) 
memory: memcecpy,memchr, .......+..-. memory(3C) 
memory operations. fmemchr, . . . . 2... 2... memory(3C) 
memory operations. 2.06. 6 eee eee ee shmop({2) 
MEMOLY.._ PlOCK:: 4. G4 eS ea wwe Se a plock(2) 
memory segment identifier. .. . 1... 6. ee ee ee shmget(2) 
memset: memory operations. ....-....046- memory(3C) 
menus and command forms. . ... 1... 56 ee eae astgen(1) 
MOTO MES. for. S Soe ee te Saal es Bie da Hs So OE tie sort(1) 
merge or add tota] accounting ........4.-. acctmerg(1M) 
merge same lines of several . . 2 2. 2. 1... eee ee paste(1) 
mesg: permit or deny messages. . . 2. 2. 2. 2 ee we mesg(1) 
message control operations. . 2. 6 6 1 ee ew ew ee msgctl(2) 
message from asockel. . 2 1 1 2 1 6 ww te ee ee recv(2) 
message. fformatand . ...... 4. 2. 2 e eae nlsrequest(3n) 
message Offastream. 2 2. 6. 1 ee eee we ee getmsg(2) 
message Onastream. ..... 2. 5 2 ee ee eee putmsg(2) 
message Operations. 2... 6 1 2 ee et ee ee msgop(2) 
message processing system. .......-+.e.e-s.s mailx(1) 
Message Protocol... 2. 6s 6s 6 ee Ge ae icmp(7) 
MIESSERE GUEUE. © oe a et oS msgget(2) 
message queue, semaphore set... 1 1 ew ew ee ee iperm(1) 
MESSAGC: 2 2 & G&A ecg Se eee SO I OHS t_error(3n) 
message toasocket. . 2. 2 6 6 2 we ee we we ee send(2) 
WICSSAGES.... SS 2s Ree A ee KE eo mesg(1) 
messages. /ermo, sys_ertlist, . . . 2... ee ee ee perror(3C) 
INOSSAGCS 556. ue S, 8 eee OS RS Sw BK strace(1M) 
Mini, MEPa,; UNIXHC,,. 2s 6k RS ew machid(1) 
minor device onaSTREAMS ........+.-e4e+e8-8 clone(7) 
miti, mini, mega, unixpc,, «2. 6 ee ee ee te machid(1) 
mkdbsym: load symbolsin ........+..-. mkdbsym(1M) 
mkdir: make a directory. . . . 2... 2. ee ee wee mkdir(2) 
mkdir, mkdirs: make .....-+ +4. ee eee eee mkdir(1) 
mkfs: construct a file system. . . 2... 1 6 ee eee mkfs(1M) 
mkfs(1) proto file database. . . 2. 2... 2.1. ee eee qinstall(1) 
mkhosts: make nodemame ....... 2. eee mkhosts(1M) 
mkifile: make anifie froman ......-..4ee8- mkifile(1M) 
mklost+found: make a . . . 2. ee. ew ew ew eee mklostfnd(iM) 
mknod: build special fle. . . 2... 1. 6 ee ew eee mknod(1M) 
mknod: make a directory,ora . . 2. 6 ee ee eee mknod(2) 
mkshlib: createashared . 2... 1... pee eee mkshlib(1) 
mktemp: make aunique file .........+.-. mktemp(3C) 
mktpy, mvtpy: install or 2 1 ww ee eee ee ee mktpy(1) 
mm, checkmm: print/check .. 2... 2-1. 6 2 ee eae mm(1) 
MM macro package for . 2. 2 1 eee ee ee ew ee mm(5) 
MM macros. /print/check . 2... 1.1 6 1 ee ee eee mm(1) 
mm: the MM macro package for ... 2... 1 we ee mm(5) 
mmt, mvt: typeset documents, . 2. 2 2 6 6 ee ee ee mmt{1) 
mnttab: mounted file system ......4..-.2+.+.6.., mnttab(4) 
MNOUE. 63-8- ss Se eo WS cS: Be OS Ss Swe Sy a, Ee ed chmod(1) 
WMOUE tridsh.. <2 6-0 sn we ew le Se wt SS umask(1) 
MOUE OF MOR, ike ee a ec wk A a chmod(2) 
modes, speed, andline/ . . 2... 1. 1 we eee ee getty(1M) 
modes, speed, andline/  . . 2 7 7 1 we ee ee uugetty(1M) 
modest-sized programs. . . 2-6 ee ee ee we ee bs(1) 
modf: manipulate partsof .. 2... ......0.2- frexp(3C) 
modification times ofa file. . 2... 1... 6 ee we ee touch(1) 
modification times. . ... 2. + e+ es ee eee eee utime(2) 
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Interface cooperating STREAMS 
read/write interface STREAMS 
/ckpacct, dodisk, lastlogin, 
profile. 


mount: 

and remote/ mount, umount: 
rmnttry: attempt to 

mountd: NFS 

setmnt: establish 

systems. mountall, umountall: 
System/ nmountali, numountall: 
rmountall, ramountall: 
unmount multiple file/ 

server, 

mnttab: 

rmtab: remotely 

rmntstat: display 

rmount: queue remote resource 
showmount: show all remote 
mvdir: 

cp, In, mv: copy, link, or 
lseek: 

the LP scheduler and 
formatting a permuted index. 
ferand48, lrand48, nrand48, 


operations. 


fumountall: mount, unmount 
poll: STREAMS input/output 
select: synchronous I/O 

sxt: STREAMS 

run commands performed for 
typesetling view graphs and/ 
cp, in, 


graphs, and slides. mmt, 
PT or GT local/ mktpy, 
server. 

test for floating point 
processing language. 
systems processed by fsck and 
from i-numbers. 
mathematical text for/ eqn, 
definitions for eqn and 
File. 

networks. 


host. getservaddr: get 

values between host and 
netcf: 

setnetent, endnetent: get 
/numountall: mount, unmount 
statistics. nfsstat: 

/sethostent, endhostent: get 


module. timod: Transport... 2 6 ee eee . . . « timod(7) 


module. /Transport Interface... ...-+.-- . . . « tirdwr(7) 
monacct, nulladm, prcetmp,/ ......... . . . acctsh(1M) 
monitor: prepare execution... 1... ess . . . monitor(3C) 
moo: guessing game. . . 2. + 1 ee ee te ee ee es moo(6) 
more, page: text perusal. 2 2 - - + - - e e - . . + » more(l) 
mount afilesystem. . . 2... - + ee eee . . . » mount(2) 


mount and unmount filesystems ....... . . » mount(1M) 
mount remote resources. ..... 2. eee - « » Fmnttry(1M) 


mount request server, 2 2 6 ee ee ee ee ee mountd(1M) 
mount table: 2.2" 4: 5. 26st SG Se ae we . . « setmnt(1M) 
mount, unmount multiple fle ........ . « mountall(iM) 
mount, unmount Network File... ... 4... . nmountall(1M) 
mount, unmount Remote File/ . . ...-.-.. rmountall({1M) 
mountall, umountall: mount, . .....-... . « mountall(1M) 
mountd: NFS mount request 2. 2 we eee . .« mountd(1M) 
mounted file system table. . . 1... +--+ ee ees mnttab(4) 


mounted file system table. . . 2... 1 2 ee . « + « mmtab(4) 
mounted resource information. ....... . . . mmntstat(1M) 
IOUNES:. “dod eee Bw A HE Se Rh. oe rmount(]M) 
IMOUNES. 6 G36 en ae ei SR Wi ey en Ba ee . showmount(1M) 


move adirectory. . - - 2 2: 0: 2: 2 2: 2 = ¢ + « mvdir(1M) 
move files: 0 e464 & eS Wwe a et ee she) a Bs cp(1) 
move read/wnie file pointer. . 2. 2 6 ee et ee ees lseek(2) 
move requests. /start/stop  . 2. 2 6 ee ee ee Ipsched(1M) 
mptx: the macro package for... 2 1 eee ee ees mptx(5) 
mrand48, jrand48, srand48/ . . . 1... 2 +e eee drand48(3C) 
ms: text formatting macros. . . . .- 2... + +e ew eee ms(5) 
msgctl: message control . 1 1 1 1 ee te ee ee msgctl(2) 
msgget: get message queue. . - - . - - ++ ee ees msgget(2) 
MSgop: message Operations. . . . 1. 2 2 ee ew es msgop(2) 


multiple file systems. . . 2... 2 ee ee es . « mountall(1M) 
multiplexing... <: 60s en bs ee ee a a poll(2) 
multiplexing. . . 2... 2 + ee ee eee . » « « Select(2) 


multiplexor. -2.6< 5m, -s- hovered sxi(7) 
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the symbol table of a common 
number entries in a common 

C source listing from a common 
mkifile: make an ifile from an 
nm: print name list of common 
information for a common 
section header for a common 
information from a common 
entry. /symbol name for common 
format. syms: common 

file header for common 
directories. cpset: install 

ld: link editor for common 

sizes in bytes of common 

find ordering relation for an 
number. factor: 

od: 

functions. 


query Remote I/O Processor for 
reading. Idopen, Idaopen: 

fopen, freopen, fdopen: 
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for command. 
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pointer in astream. /rewind, . ......-....-. fseek(3S) 


POMMGES © 6 6.50! sa: oa! Se a Me ae Bote Se aa lseek(2) 
poll: STREAMS input/output 2... 1... ee ee eee poll(2) 
popen, pclose: initiate pipe... 1... 1 ee ee popen(3S) 
port. dbconsole: change the... ...---.. dbconsole(1M) 
port error statistics. . 2... 6 6 1 2 2 ee ee ee as serstat(1M) 


portnumber. . 2506 6 se ete te te oh tw getrpcport(3) 
portto RPC program number... 2... 2.2.6. portmap(1M) 
portable archives. /archive . 2... 1 ee we wee wee ar(1) 
portions of pathnames. . ... 1... ee ee ee basename(1) 
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program number mapper. 
banner: make 

logarithm, exp, log, log10, 
/sqrt: exponential, logarithm, 
bre, bcheckrc, drvioad, 


Aastiogin, monacct, nulladm, 
/monacct, nulladm, prctmp, 
for wroff. cw, checkcw: 
monitor: 

cpp: the C language 

includes: determine C language 
accept, reject: allow or 

unget: undo a 

profiler. 

profiler: prfid, prfstat, 

prfsnap, prfpr:/ profiler: 
/prfstat, prfdc, prfsnap, 
systern/ /prfid, prfstat, prfdc, 
prfpr:/ profiler: prfid, 

factor: obtain the 

graphical/ gps: graphical 
types: 

window: window management 
interesting, adage. fortune: 


of a file. sum: 
editing activity. sact: 
cat: concatenate and 


pr: 
vprintf, vfprintf, vsprintf: 
printf, fprintf, sprintf: 

host system. hostid: set or 
Ipstat: 

object file. nm: 

system. uname: 

news: 

proto file; set links/ qlist: 
infocmp: compare or 

file(s). acctcom: search and 
domain and network/ dname: 
of common object files. size: 
strace: 

of the/ hostname: set or 
associated with an. bcheck: 
names. id: 

formatted with/ mm, checkmm: 
lp: parallel 

requests to an LP line 

or relocate a PT or GT local 
Ipset: set parallel line 

Ipr: line 

disable: enable/disable LP 
print formatted output. 
rtpenable: real-time 

nice: run a command at low 


pormap: DARPA pontoRPC .......... portmap(1M) 
DOSUEISs. ski. 6) 6 ho) ah We Wicke Bo diver er get Bee a od we SS banner(1) 
pow, sqm: exponential, .. .. 2.2. 2. ee ee eae exp(3M) 
power, square root functions. . . . . 2. 2 ee ee ee exp(3M) 
powerfail: system/ 2. 6 ew eee ee ee ee bre(1M) 
Or prasit GEN... ke ee ae ast es ee eth, Beg Seb pr(1) 
prctmp, prdaily, prtacct/ 6 2 1 ee ee ee ee acctsh(1M) 
prdaily, prtacct, runacct/ 6 ww ee ee ee te acctsh(1M) 
prepare constant-width text . 2 2 6. 6 2 ee ee ee ee cw(1) 
prepare execution profile. ..........+-+.. monitor(3C) 
PREDIOCESEOT. ges Se ks ers we SS, ee Se cpp(1) 
preprocessor include files. . . 2... 2. 6 es se eee includes(1) 
prevent LP requests, . 2... 1 ee eee ee eee accept(1M) 
previous get of anSCCSfile. 2 2. 2 2 1 ee ee ee unget(1) 
prf: operating system. www ee ee ee ee es prf(7) 
pridc, prfsnap, prfpr:/ «2 6 6 6 ee ee te ee profiler(1M) 
prfid, prfstat, prfidc, 2... 2. 1-2 2 ee ee eee profiler(1M) 
pripr: operating system/ ...... 2.2... eas profiler(1M) 
prisnap, prfpr: operating . 2... 6 ee ee ee ee profiler(1M) 
pristat, prfdc, prfsnap, . 2... 6 2 ee ee ee ee profiler(1M) 
prime factors of anumber. ..... . 2. ee ee as factor(1) 
primitive string, formatof ... 1... 6. 2 2 2 ee eae gps(4) 
primitive system datatypes. . . 2. 2. 2 2 2 ee ee ae types(5) 
POMMILIVES., se ee 6K Ss Ss we Oe Re Be AS window(7) 
print a random, hopefully . 2... 2.2 26 2 ee eee fortune(6) 
sprintanSCCS file; 3: s)4-.6) het ea we eK Se eo wR prs(1) 
: print andsetthe date... 2... ee ee ew ee te we date(1) 
STING Calendar. jee parca Se te W 4 k Bi ay OS ye, hs cal(1) 
print checksum and block count... ........-. sum(1) 
print carrent SCCS file 5... see ee ww . sact(1) 
print Ales. 4-4. 4 wise. oS pita pay fale SMe en Gaile Se Yen Beh ae cat(1) 
Print files. gece ts ee wr ae, SR ee de We 8 - pret) 
print formatted output of af. . 2... 2 2 ee ee vprintf(3S) 
print formatted output, 2. 6 6 6 we ee ee ee printf(3S) 
print identifierof current . . 2... 2. ewe . « « hostid(t) 
print LP status information. ... 2... 6. eee ee Ipstat(1) 
print name list ofcommon ... 2. ee ee ee ee es nm(1) 
print name of current CTIX 2. 2. 1. 1 eee ee ee uname(1) 
print news items. . 2... 6 6 1 ee ee ee es news(1) 
pnnt out file lists from 2. 6 6 ee ee ee ee ee qlist(1) 
print out terminfof ... 1... 2. eee eee infocmp{1M) 
print process accounting . 2... 1 6 we ee eee acctcom(1) 
print Remote File Sharing ........-..4.24.-. dname(1M) 
print section sizes in bytes . 2... 1 ew ee ee ee size(1) 
print STREAMS trace messages. .. ....-. 2s. strace(1M) 
print the Internet hostname .... +... 2+ eee hostname(1) 
print the list of blocks . 2... 2.2 2 ee ee ee bcheck(1M) 
print user and groupIDsand .......... 5+. id(1M) 
print/check documents... . 1. 2 2 eee ee we mm(1) 
PHIMEr MIEMACES eS a eS ew eS 6 1p(7) 
printer. /cancel: send/cancel . . . . - 2 2 1 7 2 we eee Ip{t) 
printer. /nvtpy: install . 2... 1 1 we ee ee ee mktpy(1) 
printer Oplions. 26: es So-e Ses WS we) we Ipset(1M) 
printer $pooler. . 3-9: 6. 3. eo eS OS BH we eH Ipr(1) 
printers; enable... 6-3. ..0 se Se ee WS eS es ar enable(1) 
printf, fprintf, sprintf; 2... 2. 2 ee ee ee ee printf(3S) 
priorities enabled/disabled. . .......... rtpenable(1M) 
PNOHIV:: 6. .ak 4 te ee SR Ce eS OS eS nice(1) 
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nice: change 

changing nice. renice: alter 
errors. errpt: 

acct: enable or disable 
acctprcl, acctprc2: 
acctcom: search and print 
alarm: set a 

tumes. times: get 

/alter priority of running 
init, telinit: 

timex: time a command; report 
exit, exit: terminate 

fork: create a new 

/getpgrp, getppid: get process, 
setpgrp: set 

process group, and parent 
inittab: script for the init 
kill: terminate a 

nice: change pnonty of a 
kill: send a signal to a 
initiate pipe to/from a 
getpid, getpgrn, getpnid: get 
Remote File Sharing daemon 
ps: report 

memory. plock: lock 
times: get process and child 
wait: wait for child 

ptrace: 

pause: suspend 

wait: await completion of 
fist of file systems 

to a process or a group of 
killall: kill all active 
structure. fuser: identify 
awk: pattem scanning and 
nawk: pattem scanning and 
extproc: tum extemal 
mailx: interactive message 
rtab: Remote I/O 

en: Ethemet 

enpstart: configure Ethemet 
riopqry: query Remote I/O 
m4: macro 

system for Remote I/O 

a common object file. list: 
t_error: 


function. 

profile. 

prof: display 

monitor: prepare execution 
profil: execution ume 
environment at login time. 
prof: 

fusage: disk access 

prf: operating system 
pride, prfsnap, prfpr:/ 
prfpr: operating system 


priority of a process. 2. 2 2 6 6 ee ee ee ee ee nice(2) 


priority of running processby .... +--+ +++: renice(1) 
process areport oflogged . 2... 2 1 1 ee ee ee ermpt(1M) 
process accounting. . . 6 ee ee ee ee te ee te acct(2) 
process accounting. .. 1... ee ee eee eee acctprc(1M) 
process accounting file(s). . . 2. 2... eee eee acctcom(1) 
processalarm clock. .. 2. 2.6 eee ee ee wee alarm(2) 
process and child process 2 2 1 1. 1 we ee eee es times(2) 
process by changing nice. . . 2. 2. e+ ee ee eee renice(1) 
process control/ 2. 6 6 ee ee ee te eee init(1M) 
process data and system/ . . . - 6 e+ eee ee eee timex(1) 
DIOCESE: gece ew, Seo we ewe ane a RR ee exit(2) 
PIOCESS. od SSeS eee ee es ee fork (2) 
process group, and parent{/ . . 1. 1 1 6 ee ee ees getpid(2) 


process groupID. . . 2. 2. 1 2 ee ee eee ee setpgrp(2) 
process IDs. /get process, . 2 2 6 6 ee ee ee ee getpid(2) 
DIOCESES ket es See ee ES ee re inittab(4) 
PTOCESS, isla ek Ss ee ee SS eS a ae eR kill(1) 
PYOCESS ey. di. EE ce So a A ww EC aw nice(2) 
process oragroupof/ . 2... 6 ee ee ee ee ee kill(2) 


process. popen, pclose: 2 6 6 6 we te ee ee popen(3S) 
process, process group. and/ ... 2. 6-6 ee ee es getpid(2) 
process. rffudaemon: .....-+-.+++s4+ee6-. rfudaemon(1M) 
process status. 6 6 6 we ee eet tw ee ee te ps(1) 
process, text,ordatain . 2... ee ee te ew ee plock(2) 
PROCGSS LIMES: 5 Serge aed Se el we ae times(2) 
process to stop orterminate. 2... 2 ee ee ee ee es wait(2) 
PYOCESS WFACE:: a: eS ee eS ergs SS eS ptrace(2) 
process until signal. . 2 6 1 1 2 ee ee ee ee ee pause(2) 
WYOCESS. kk ew a we we wait(1) 
processed by fsck and ncheck. .... 1... 2. ees checklist(4) 
processes. /sendasignal . . . 2... 1 2 + ee et eee kill(2) 
PROCOSSEG:. i si es ee ee RO A killali(1M) 
processes using afileorfile ..........446. fuser(1M) 
processing language. . . . 2... 2 6 ee ee ee ee awk(1) 
processing language. . 2... 1 2 we ee ee we we nawk(1) 
processing onoroff. 2... 2 6 1 ewe ee ee extproc(1M) 
processing system. 2. 2. 26 6 1 ee ee ee ew ee mailx(1) 
Processor configuration table. . . 2... 2. 2 2 we eee rtab(4) 
PROCESSOR» “gece: eee 5 Ge ete: Rok Se) Be Ya ae nes te: Si ee en(7) 
PIOCESIOT) 6 i eee BS eS a enpstart(1M) 
Processor for online data... . 1... 2.6.2.5 riopqry(1M) 
PIOCESSOM se bk: Se we ceo hk Me oA Se, BOE OS m4(1) 
Processor. riopcfg: configure ........... nopcfg(1M) 
produce C source listing from . . . 1. 1 1 1 we ee ee list(1) 
produce errormessage. . . 1... 2 ee ee we eee t_error(3n) 
prof: display profile data. . 2... 1... 2. 2 ee eee prof(1) 
prof: profile within a... 6.506 6 e666 6 2 Se ee prof(5) 
profil: execution time ...... 6. 6 eee ee eee profil(2) 
pronle Gata '.s: 6° 6. 2.454. w a Soo & ONS SSS a we we prof(1) 
PrOme. ye SoS -Sec¥. at ad 2 ee Be BR monitor(3C) 
DIONE: ase Rs SS b> aS tone. BN Se Ae ee profil(2) 
profile: setting upan 2... 1 1 ee ee ee ee profile(4) 
profile within afunction. .... 2... 2... ee eee prof(S) 
PPONIER, «2 ck gee dlas ge hs MG, Seer ie tw ee Et s&s, fusage(1M) 
POMEL. 46.8 8 ae ca. i Ee a, Be ra prf(7) 
profiler: prfld, prfstat, . 2... 2. ee ee eee profiler(1M) 
profiler. /prfdc, prfsnap, . .. 2... 26 ee ee profiler(1M) 
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sadp: disk access 
standard/restricted command 
software using the mkfs(1) 
on. /print out file lists from 
arp: Address Resolution 
/switched Senal Line Internet 
/setprotoent, endprotoent: get 
inet: Internet 

icmp: Intemet Control Message 
ip: Internet 

DARPA Intemet File Transfer 
telnetd: DARPA TELNET 
DARPA Trivial File Transfer 
Intemet Transmission Control 
user interface to TELNET 
interface to the DARPA TFTP 
udp: Internet User Datagram 
Dialers: ACU/modem calling 
protocols. 

information. t_getinfo: get 
update: 

anthmetic: 

systems. labelit: 

true, false: 

get name of transport 


fnulladm, prctmp, prdaily, 


/generate uniformly distributed 
/mvtpy: install or relocate a 
download. tdl, gtdl, 


stream. ungetc: 

put character or word on a/ 
character or word on a/ putc, 
environment. 

stream. 

entry. 

stream. 

password file entry. 
/getutent, getutid, getutline, 
a/ putc, putchar, fputc, 

file checkers. 

/etc/shadow with information/ 


/etc/shadow with information/ 
gic: interface for 

software using the mkfs(1)/ 
from proto file; set links/ 


tape. stape: SCSI 

File Sharing name server 
online data. riopqry: 

tput: initialize a terminal or 
queuedefs: at/batch/cron 
msgget: get message 
rmount: 


PONE sen asp 6's, Se SS a Ho SS ee we sadp(1M) 
programming language. Ahe ..- .- 2.2.2 se pee sh(1) 
proto file database. Werify .. 2. 2... 2 ee eee qinstall(1) 
proto file; setlinks based . 2... 2 2 ee we ee wee qlist(1) 
Procol. 4! re-do OS oe ee ok Bw St at ee eh ee arp(7) 
Protocol control facility, . ...-. 6.2... 580.-. slipd(1M) 
protocolentry, . 2... 2 ee ee ee ew ee getprotoent(3) 
protocol family (<i ek en SA a RES Bw inet(7) 
PHOLOCODS ss. ig) ed. sk We a tw ta oR, ies Se icmp(7) 
PROIOCOL <5. i. ig: 5S tw Sy Bch hm Geel ae as Se. Bh ge we ip(7) 
Protocol server. ftpd: 2... 1. 6 1 ew we eee ee le ftpd(1M) 
PIOLOCOl SEIVEN:) 3.6 Ge woe oan BP we SE ee telnetd(1M) 
Protocol server. tftpd: 2. 2. 2 6 eee ee ee ee tftpd(1M) 
PROAOCOL ICP gc Tw ae Ste ie ae Bs tcp(7) 
PIOOCO]. CEMNGTS cg Sa ee: ee SE oe we a ey Uw: telnet(1) 
PIOOCOL, “TEP? WRER sees ek es eR Sw a Gee? wees tftp(1) 
PYOUGCOLS es ce &: Jee a Sis ee ES AS We SG udp{7) 
POONOCOIS.. | 3:5 1s oe Boek Miter ORAS eG Ee Dialers(5) 
protocols: list of Intemet .........-662. protocols(4) 
protocol-specific service... ... 2.6 ee eee t_getinfo(3n) 
provide disk synchronization. .......- +... update(1M) 
provide drill in number facts. . ....... . - - anthmetic(6) 
provide labelsforfile .. 2... 2. 2.1 ee wees labelit(1M) 
provide truth values. 2. 2. 2 1 6 ee ee ee ee ee true(1) 
provider. nisprovider; . . 2... 2 ee ee ee nisprovider(3n) 
prs: print an SCCS file; 2 8 2 co et ee ee prs(1) 
prtacct, runacct, shutacet/ . 2... 2 2 ee ee acctsh(1M) 
pS: report process status. 2. 2... ew ee ee ee ps(1) 
pseudo-random numbers. . . . 2... 2... 2 2 ee drand48(3C) 
PT or GT local printer. 2... 1 6 ee ee ee ee mktpy(1) 
pidl: RS-232 terminal: <3) sd: 6. 65 eek Sr ee ee tdi(i) 
pirace: process trace. 2... 6 + ese et he te ee ptrace(2) 
ptx: permuted index. 6 2 6 6 wwe ee ee ee ee pu) 
push character back intoinput ........4s. ungetc(3S) 
putc, putchar, fputc, putw: 2. 6 6 eee ee ee es putc(3S) 
putchar, fputc, putw: put 2. 2 2 6 1 ee ee ee ee putc(3S) 
putenv: change oraddvalueto ........2.-. putenv(3C) 
putmsg: send amessageona .......-.6.4e08-. putmsg(2) 
putpwent: write password fille ........4.. putpwent(3C) 
puts, fputs: put aastringona .......+.e4e68- puts(3S) 
putspent: write shadow 2 ww wwe we es putspent(3X) 
pututline, setutent,endutent/ .......-..00-8 getut(3C) 
putw: put character orwordon 2. . 2... 2 2 2 eee puic(3S) 
pwek, grpck: password/group . . . 2... 2.2 eee pwek(1M) 
pweonv: install andupdate . 2... 2 ee eee pweonv(1M) 
pwd: working directoryname. ...... 2.6 ee nee pwd(1) 
pwunconv: install and update .......2... pwunconv(1M) 
OIC TAGs» 6 ar a ae Se SS Se AO gic(7) 
qinstall: install and verify . 2... 2... 2. ee qinstall(1) 
glist: print out file lists . 2... 2. 6 ewe wee ene qlist(1) 
qsort: quicker sort. 2 2 1 ee eee ee et te ee qsort(3C) 
quarter-inch and half-inch . «1 1 ew ew ee ee ee stape(7) 
query. nsquery: Remote... 2... 2 1 ee ee nsquery(1M) 
query Remote I/O Processorfor .......+.-6- nopqry(1M) 
query terminfo database. . . 2... 1-7 ee wee we tput(1) 
queue description file. . ......2. 22+ see queuedefs(4) 
GUCUE.. Sock. Se Sh “SS Be ec ee eS ee msgget(2) 
queue remote resource mounts. ......+-+..8. rmount(1M) 
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ipcrm: remove a message 

request. rumount: cancel 
description file. 

qsort: 

command immune to hangups and 


random-number generator. 
adage. fortune: print a 
rand, srand: simple 

fsplit: split FORTRAN, 
dialect. 

ratfor: 

stop the operating system. 
performed for multi-user/ 
for multi-user/ rc2, 
execution. 

routines for returning a/ 


getpass: 

entry of a common/ Idtbread: 
header/ Idshread, ldnshread: 
in a file. getdents: 

read: 

rmail: send mail to users or 
line: 


member of an/ ldahread: 
common object file. ldfhread: 
directory: opendir, 

open a common object file for 
open: open for 

lseek: move 

tirdwr: Transport Interface 
allocator. malloc, free, 
mallinfo: fast/ malloc, free, 
enabled/disabled. rtpenable: 
reboot: 

mail aliases/ newaliases: 
specify what to do upon 
t_rcvrel: acknowledge 
t_rcvudata: 

socket. recv, recvfrom: 
indication. t_rcvuderr: 

sent over a/ t_rcv: 

a connect/ t_rcvconnect: 
lockf: 

from per-process accounting 
from/ errdead: extract error 
manipulate connect accounting 
tape. frec: 

message from a socket. 
from a socket. recv, 

ed, 

execute regular expression. 
compile. 

make: maintain, update, and 
regular expression. regcmp, 
compile and match routines. 


queue, semaphore set or shared/ . . 2... 6 + 2 ee es iperm(1) 
queued remote resource... . 1... ss . rumount(! M) 
queuedefs: at/batch/cron queue ....... . queuedefs(4) 
quicker sor. 6. 1 we ee ee te ee ee ee qsorn(3C) 
quits. nohup: mna .. 1 ee ee ee ee ee ee nohup(1) 
quiz: test yourknowledge. ©... 2-2-2 + es ee eee quiz(6) 
rand, srand: simple . . . - - 6 ee et ee eee ee rand(3C) 
random, hopefully interesting, . . .-. - + + + eee fortune(6) 
random-number generator. . . 2. 1 2 5 + ee eee rand(3C) 
PAULOTOF CLL TES; ose Shi ow eR we owe fsplit(1) 
ratfor: rational FORTRAN ......-+6 +. 2. es eee ratfor(1) 
rational FORTRAN dialect. . ....- +2 es eee ratfor(1) 
rcO: run commands performed to. . 2s ee ee ee rcO(1M) 
rc2, rc3: run commands . 1 ww ee et et te rc2(1M) 
rc3: run commands performed . . 2... 1 ee ee ees rc2(1M) 
remd: remote shell command ..... 21. se + se eee rcmd(1) 
romd, rresvport, ruserok: 6 6 6 6 ee ee ee ee es remd(3) 
rcp: remote file copy. 2. 2 6 6 ee eet ee ee ee rep(1) 
read apassword. . 2. 1 6 6 ee ee ee et we ee getpass(3C) 
read an indexed symbol table .....+-+.-+-+.- idtbread(3X) 
read an indexed/named section .... + 2. + 2 oe idshread(3X) 
read directory entries and put... ..-. +--+ +e. getdents(2) 
read from filé, .. «6 (¢-0- 5 we 6 ee ee we ee ow read(2) 
fead mail, ‘mail, 6c 2) jhe 2) 6 ee ee mail(1) 
read one lines. 6. © 6. i are Seow ew Se em line(1) 
read: read fromfile. . 2... 1. 2 2 ee ee ew www read(2) 
read the archive headerofa ........ + wes Idahread(3X) 
read the file headerofa .......+ ++ ses ldfhread(3X) 
readdir, telldir, seekdir/ . .......--e0868. directory(3X) 
reading. Idopen, Idaopen: . . . 1.2. 6 ee ee ee Idopen(3X) 
reading or writing, . . 1... 2 ee ee ee ew wee open(2) 
read/write file pointer. 2. 2 6 1 1 ee ee ee ee es lseek(2) 
read/wnite interface STREAMS/ .........4.-6 urdwr(7) 
realloc, calloc: main memory ......-.. 2.2... malloc(3C) 
realloc, calloc, mallopt, . ... 2... +e eee malloc(3X) 
real-time priorities . . 1... 6 1 ee ew ee ee rtpenable(1 M) 
reboot the sysiem. . 2... 6 2 1 eee ee ee reboot(1M) 
rebuild the database forthe ......:+ +26. newaliases(1) 
receipt of asignal. signal: . . . 6. 2 7 + ee ewes signal(2) 
receipt of an orderly release/ . . 2... 2 +e ea t_revrel(3n) 
receive adataunit. ... 6. 2. es eee ee wae t_rcvudata(3) 
receive amessage froma ...... +++ eee eee recv(2) 
receive aunit dataerror . . 1. 1 1 1 et ew wes t_rcvuderr(3) 
receive data or expedited data... 1.2 1 eee t_rev(3n) 
receive the confirmation from ........4.. t_rcvconnect(3) 
record locking on files. . . 2... 2 ee ee ee ee lockf{3C) 
records. /command summary ......+.-. 26s acctcms(1M) 
records and status information .......-..06. errdead(1M) 
records. fwtmp, wompfix: . 2... 2. +--+ eee. fwtmp(1M) 
recover files fromabackup .......4+..-24.-. frec(1M) 
recv, recvfrom: receivea . . 1. 1 1 ee eee ee ew recv(2) 
recvfrom: receive amessage . . 1. 6 1 ee et we te es recv(2) 
fed: Text editor: 6%. ec “2 we eS we a dB ed(1) 
regcmp, regex: compile and .. 2... 2. ee eee regemp(3X) 
regemp: regular expression . . 2. 2 ee ee ees regemp(1) 
regenerate groups of programs. .....+..+...ee-s make(1) 
regex: compile and execute... ...+-+.-2.. regemp(3X) 
regexp: regular expression . . «2. 6 1 ee ee wee regexp(5) 
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locking: exclusive access to regionsofafile. 2... 2... 6. 2 ee ee ee locking(2) 
match routines. regexp: regular expression compile and .........2.- regexp(5) 
regemp: regular expression compile. . 2 2. 2 2 2 eee ee regcmp(1) 

regex: compile and execute regular expression. regemp, ....-...+ ++... regemp(3X) 
file for a pattem using full regular expressions. /searcha . 1... 6. - 2 ee ee egrep(1) 
requests. accept, reject: allow orprevent LP . . 2... . 1... ee accept(1M) 

sorted files. comm: select or reject lines common totwo .. . 2... 2 ee ees comm(1) 
lorder: find ordering relation foran object/ . . 2. 1 1 1 ee ee te te lorder(1) 

join: relational database operator, . 2... 2 6 1 ee ee ee join(1) 

freceipt of an orderly release indication. . . 2... ee ee ee eee t_rcvrel(3n) 
t_sndrel: initiate an orderly release. 2. 6 1 1 ww eee ee ee te t_sndrel(3n) 
for a common object file. reloc: relocation information ........-4.44... reloc(4) 
mktpy, mvtpy: install or relocate aPTorGTlocalfy .. 1... 2... 2-2 eee mktpy(1) 
Idrseek, Idnrseek: seek to relocation entries ofaf . . . . 1... 2 ee ew ee ldrseek(3X) 
common object file. reloc: relocation information fora . . 2... 6 ee ee ee reloc(4) 
/fmod, fabs: floor, ceiling, remainder, absolute value/ . 1... 1. 1. 1 1 ee ee floor(3M) 
calendar: reminder service. . . . . 1. 6 2 2 ee ew ee wes calendar(1) 

adv: advertise a directory for remote access. . 2. 6. 6 6 6 6 se ee ew ee te adv(1M) 
for returning a stream to a remote command. /routines . . . 6. 2 6 1 6 ee ee ee remd(3) 
uuxqt: execute remote command requests. . . 2. 2 2 6 ee ee eee uuxqt(1M) 

rexec: retum stream toa remote command. ...... 4. 26 + ee © se ew we wee rexec(3) 
thosts: remote eanivalent users, . . . . mosis(4) 

rexecd: remote execution server. . 2... 1 ee ee eee rexecd(1M) 

rep? remote file CODy.. «°c: Ao se: oie a ee Se ew oe S SS rcp(1) 

administration. rfadmin: Remote File Sharing ........2.2.60686. tfadmin(1M) 
process. rfudaemon: Remote File Sharing daemon ..........- tfudaemon(1M) 
network names. dname: print Remote File Sharing domain and .........., dname(1M) 
environment. rfstop: stop the Remote File Sharing ...... 2-2... ee eee rfstop(1M) 
password. rfpasswd: change Remote File Sharinghost .........4..-. rfpasswd(1M) 
server master file. rfmaster: Remote File Sharing mame ..........+46-5 rfmaster(4) 
server query. nsquery: Remote File Sharing name .......2..4..-. nsquery(1M) 
notification shell/ rfuadmin: Remote File Sharing .......4...++-6-. rfuadmin(1M) 
unadv: unadvertise a Remote File Sharing resource. ........6+426-. unadv(iM) 
/ramountall: mount, unmount Remote File Sharing (RFS)... ........ rmountal](1M) 
rfstart: start. Remote File Sharing. . .... 2... 2 ewe eee rfstart(1M) 

group mapping. idload: Remote File Sharing userand ........4.2.. idload(1M) 
configuration table. rab: Remote I/O Processor . . 2... 1 1 1 ee et ee ee rtab(4) 
online data. riopgqry: query Remote I/O Processorfor ... 2... 2 2 ee eae riopqry(1M) 
nopcfg: configure system for Remote I/O Processor. . 2... 2 6 6 2 ee ee ee riopcfg(1M) 
Tlogin: remote login. 2... 6 1 6 ee ee ee ewe ee rlogin(1) 

flogind: remote login server. . 2. 2 2. 1 1 eee ee ee rlogind(1M) 

showmount: show all remote mounts. . . . 6... 66 ee ee eee showmount(1M) 

netrc: login file for remote networks. . 2... 6 6 1 ee ee ee we ee ws netrc(4) 

rmount: queyve remote resource mounts. . . 2... 2... 2-6 ee tmount(1M) 

rumount: cancel queued remote resource request. . . 2. 2. + 6 6 2 we ee rumount(1M) 

and unmount file systems and remote resources. fmount ..........2.2.. mount(1M) 
rmnttry: attempt to mount remote resources. ©... 1 6 6 ee ew ee ee rmnttry(1M) 
execution. remd: remote shellcommand ....... 2... ee eee roemd(1) 

rshd: remote shell server. . . 2... 6 e+ 2 ee eee eee rshd(1M) 

on. Uutry: try to contact a remote system with debugging .....4.-.2.2... Uutry(1M) 
cl: spawn getty toa remoteterminal, . 2... 1-2 ee ee ew ew et et ct(1C) 

server. talkd: remote user communication . .. 1.0.0... 224 - talkd(1M) 

server. fingerd: remote userinformation ....... 2.664084 fingerd(1M) 

table. rmtab: remotely mounted filesystem . .........4..- rmtab(4) 

file. rmdel: remove a delta fromanSCCS .........80e8-. rmdel(1) 

rmdir: remove adirectory, . . 2... 6 6 ee ew ee ees rmdir(2) 

semaphore set or/ ipcrm: remove amessage queue, .... +... eee eee iperm(1) 
unlink: remove directory entry, . . . 2... 6 eee ee we unlink(2) 
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rm, rmdir: 

eqn constructs. deroff: 
running process by changing/ 
fsck, dfsck: check and 

uniq: report 

clock: 

fsize: 

fsstat: 

communication/ ipcs: 

blocks and i-nodes. df: 

errpt: process a 

sa2, sadc: system activity 
timex: time a command; 

ps: 

file. uniq: 

rpcinfo: 

sar: system activity 

stream. fseek, rewind, ftell: 
and send listener service 
cancel queued remote resource 
mountd: NFS mount 

t_accent: accent 2 connect 
t_listen: listen for a connect 
confirmation from a connect 
send user-initiated disconnect 
reject: allow or prevent LP 

the LP scheduler and move 
syslocal: special system 

Ip, cancel: send/cancel 

uuxgt: execute remote command 
res_mkquery, res_send, 
res_init, dn_comp, dn_expand:/ 
control. arp: address 

arp: Address 

configuration file. 

resolv.conf: 

res_init, dn_comp, dn_expand: 
unmount of an advertised 
rmntstat: display mounted 
rmount: queue remote 
rumount: cancel queued remote 
a Remote File Sharing 

file systems and remote 
unmount Network File System 
attempt to mount remote 
Remote File Sharing (RFS) 
dn_expand:/ res_mkquery, 
and usage examples. usage: 
disconnect. t_rcvdis: 

common object file/ ldgetname: 
abs: 

logname: 

command. rexec: 

name. getenv: 

stat: data 

/raserok: routines for 

col: filter 

file pointer in a/ fseek, 


remove files or directories. . 2... 6 + 2 ee ee wee es rm(1) 
remove nroffftroff, tbl, and . . 1... 1 2 ee ee ew deroff(1) 
renice: alter priority of «6-6 6 - ee ee ee ees renice(1) 
repair filesystems. ©. 2 1 2 ee ee ee ee ee es fsck(1M) 
repeated lines inafile. . ©... ee eee eee eee uniq(1) 
report CPU time used. 2. 2 2 2 2 ee ee ee = + Chock(3C) 
report file size. 6 6 2 ee ee ee ee ee ee ee fsize(1) 
report file system status. 2... 6 1 ee ee ee ee fsstat(1M) 
report inter-process 6 6 ee ee ee ee te ee ee ipes(1) 
report number of free disk . 6. 2 6 6 ee ee ee ee ee df(1M) 
report of logged errors. 2. 2-6 ee ee et ee ee errpt(1M) 
report package. sar:sal, 2. 6 6 6 6 eee ee eee es sar(1M) 
report process data and system/ .. 1. +--+ ee ees timex(1) 
report process status. 2 6 1 6 6 ee eee ee ee te ps(1) 
report repeated linesina 2. 2 ee ee ee we ee es uniq(1) 
report RPC information. 2... 6 2 ee ee ee rpcinfo(iM) 
reporter, 6 2 ee ee wt tt we he ee we wet sar(1) 
reposition a file pointerina . . 2. 2 6 ee ee eee fseek(3S) 
request message. /fformat .... + s+ + + ees nlsrequest(3n) 
request. rumount: . 1 6 6 ee ee et ee rumount(1M) 
request server, 2. 2 2 6 ee ee ee ew te eee mountd(1M) 
FORNICEY rds a. Ge ee Sid GS oes Se ES eS t_eccent(3n) 
FOOUCS. 6 ee ew ee ee ws t_histen(3n) 
request. /receive the . .-- +e ee ee ee t_rcvconnect(3) 
request. t_snddis; . 2. 1. 2 2 6 ee ee ee te ee t_snddis(3n) 
requests. accept, . 2 2 ee ee ee ee ee ee accept(1M) 
requests. /lpmove: start/stop .. 2... eee eee Ipsched(1M) 
PEQUESISS <6. oe: Bo Seg Sw we Ae Be es syslocal(2) 
requests toanLPline{ «1. 1 1 1 ee ee ee ee ee Ip(1) 
FOQUCSIES.. 65 6 5 ee ee ae uuxqt(1M) 
res_init, dn_comp, dn_expand:/ . 2... 6 2 ee ee resolver(3) 
res_mkquery, res_send, ... 2... ee ee eee resolver(3) 
resolution display and . 2. 1. 2 ee ee te ee ee arp(1M) 
Resolution Protocol. . 2... . ee et ee ee es arp(7) 
resolv.conf: resolver . . 1... 2. + ee © © we ewe resolver(4) 
resolver configuration file. .. ....-+ ++ eee. resolver(4) 
resolver routines. /res send, ... 1... 2 © es we ee resolver(3) 
resource. fumount: forced .. . 1... 2 1 ew ee furnount(1M) 
resource information. . .. 2... 0.56 6 ee ee. rmntstat(1M) 
resource mountS. . 2. 2 6 2 1 es ee oe te wo ew rmount(1M) 
resource request. . 2 2. 2 2 2 es ee ZX & . rimount(1M) 
resource. unadv: unadvertise ee ee ee ee ae ee unadv(1M) 
resources. /mount and unmount . .........- mount(1M) 
resources. /numountall: mount, ......... nmountall(1M) 
resources. rmnttry: . 6. 6 6 ew we ee ew ee rmmnttry(1M) 
resources. Amount, unmount .........6.6-s rmountall(1M) 
res_send, res_init,dn_comp, . . 2... ee ee eee resolver(3) 
retrieve acommand description .........+.6- usage(1) 
retrieve information from ....... 4.6.6.5 e6-. t_rcvdis(3n) 
retrieve symbol namefor . .....+ +s. se ldgetname(3X) 
retum integer absolute value. . 2... 1. + ee ee ee abs(3C) 
return login name of user. . . ~~... + ee eee logname(3X) 
retum stream toaremote . 2... 6 6 ee ee wt tw rexec(3) 
retum value forenvironment .......-+ +... -. getenv(3C) 
retumed by stat system call, 2. 2 1 2 ee ew eee we stat(5) 
retuming astreamtoaremote/ . 1... - + ee eee rcmd(3) 
reverse line-feeds. . 2. 1... 2 eee ee ee eee ene col(1) 
rewind, fiell: repositiona . 2... 6 6. ee ee eee fseek(3S) 
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/readdir, telldir, seekdir, 
creat: create a new file or 
remote command. 
server. 

administration. 

name server master file. 
Shanng host password. 
unmount Remote File Sharing 
Sharing. 

Sharing environment. 
notification shell script. 
daemon process. 

users. 

Remote I/O Processor. 
Processor for online data. 


directories. 
read mail. mail, 
SCCS file. 


directories. rm, 

resource information. 

remote resources. 

mounts, 

unmount Remote File Sharing/ 
system table. 

chroot: change 

chroot: change 

logarithm, power, square 
routing tables. 

gateways: 

daemon. 

/tekset, td: graphical device 
rcmd, rresvport, ruserok: 
Internet address manipulation 
common object file access 
expression compile and match 
dn_comp, dn_expand: resolver 
graphical table of contents 
routed: network 

sendmail: mail 

route: manually manipulate the 
getrpcbynumber: get 

rpcinfo: report 

getrpcport: get 

rpc: Sun 

portmap: DARPA port to 

data base. 

information. 

for returning a stream/ rcmd, 
controlling terminal’ s local 
tdl, gtd), ptdl: 
standard/restricted/ sh, 


stop terminal input and/ 
configuration table. 
priorities enabled/disabled. 


rewinddir, closedir: directory/ .......4... directory(3X) 
rewrite anexisting one. . .. 1... ee ee ee eee creat(2) 
rexec: retum Stream toa ..... + + «+ «6 © se ee . rexec(3) 
rexecd: remote execution . . 6... 1 ee et rexecd(1M) 
tfadmin: Remote File Sharing . ........-... rfadmin(iM) 
rfmaster: Remote File Sharing .........---. rimaster(4) 
rfpasswd: change Remote File . ......... rfpasswd(1M) 
(RFS) resources. fmount, ......-+.+ 2.468. rmountali(1M) 
rfstart: start Remote File . .. 2... 2.2.2.2 2 eee rfstart(1M) 
rfstop: stop the Remote File ........-44.-. rfstop(1M) 
rfuadmin: Remote File Sharing . .. ....... tfuadmin(1M) 
rfudaemon: Remote File Sharing ........ rfudaemon(1M) 
thosts: remote equivalent . 2... 2 ee eee ee thosts(4) 
riopcfg: configure system for... 1... ee eee niopcfg(1M) 
riopqry: query Remote VO... 1 1 ww ee ee riopgry(1M) 
rlogin: remote login. . «2 1 ee ee ee ee ee rlogin(1) 
rlogind: remote login server, ... . 2.2... eas rlogind(1M) 
rm, rmdir: remove filesor . 2... 6 6 we ee ee wee rm(1) 
rmail: send mailtousersor ... +. + 1 es ee eae mail(1) 
rmdel: remove adeltafroman ..... 2.5.22 rmdel(1) 
rmdir: remove adirectory, . . 1... + 2. ese eae rmdir(2) 
rmdir: remove filesor 2... ..66 668624222 2. . rm) 
rmntstat: display mounted ........+.4.4.. rmntstat(1M) 
rmnttry: attempt tomount .... 2... ee eee rmntry(1M) 
rmount: queue remote resource... . 2 + ee we rmount{1M) 
rmountall, rumountall: mount, . ......4... rmountall(1M) 
rmtab: remotely mounted file . .........2.46. mmtab(4) 
FOOU CUTECIOTY >.<. ee od 1S hs Se chroot(2) 
root directory foracommand. ... ... +4... chroot(1M) 
root functions. /exponential, . . 2. 2. 6 ee we eee exp(3M) 
route: manually manipulate the 2... ......0.. route(1M) 
routed configuration file. .........4.4546-4 gateways(4) 
rovied: network routing . . . 1.1.6 6 1 ee ew wes routed(1M) 
routines and filters, 1... 1. 6 2 ee ee ee ee we gdev(1G) 
routines forretuming a/  . . 1. 1 1 1 ee we ee ee remd(3) 
routines. finet_netof: 2. 6 1 6 ee ee ee ew we ee inet(3) 
routines. -ldfemie: s.6 a. eo es a ee Ne we a a Idfcn(4) 
routines. regexp: regular. 2 1 we ww ee ee ee regexp(5) 
routines. /res_send, res_init, . ...... +2 sees resolver(3) 
routines. /dtoc, tloc, loc: www we we ee tt et toc(1G) 
routing daemon. . . . 2. 1 1 6 ee ew we ee ee routed(IM) 
routing program. . . . 1. 1 6 eee ee ee sendmail(1M) 
routing tables. n 4.4 hoe ee ie Be route(1 M) 
rpc entry. /getrpcbyname, . . ..- 2... 2 2 eee getrpcent(3) 
RPC information. 60 6 cae a we we ee rpcinfo(1M) 
RPC portnumber, 2... 6 1 ee ee ee es getrpcport(3) 
rpc program number data base. 2... 1. 1 1 ee ee ee rpc(4) 
RPC program number mapper. ........8-. portmap(1M) 
rpc: Sun rpc program number . 2... 1 6 we ee ee Tpc(4) 
tpeinfo: report RPC 4. ct tt tt wt rpcinfo(1M) 
rresvport, mserok; routines... 1. 1 ee ew eee remd(3) 
RS-232 channels;..0p?:: 4-0) 6:2? we? Gove 6 sR wr Bs OG tp(7) 
RS-232 terminal download. . . . 2... 1. ew ee ee tdl(1) 
nah? shell, the: << -.4 <4 a: <s« %. 18 ee. ees Ae eR eS sh(1) 
rshd: remote shell server, . 2. 1 1 6 1 ee pw wine rshd(1M) 
rsterm: manually startand . .. 1... 2... 2. eee rsterm(1M) 
rtab: Remote I/O Processor... 1. ee ee te ees rtab(4) 
rtpenable: real-time 2 6 2 6 6 ee ew ee ee ee rpenable(iM) 
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resource request. 

Remote File/ rmountall, 
nice: 

hangups and quits. nohup: 
multi-user/ rc2, rc3: 

the operating system. rc0: 
runacct: 


/prctmp, prdaily, prtacct, 
renice: alter priority of 
nodes on local network. 
retuming a/ rcmd, rresvport, 
local network. 


activity report package. sar: 
report package. sar: sal, 
editing activity. 

package. sar: sal, sa2, 


activily report package. 


space allocation. brk, 
formatted input. 

bfs: big file 

language. awk: pattern 
language. nawk: pattem 

the delta commentary of an 
comb: combine 

make a delta (change) to an 
Sact: print current 

get: pet a version of an 

prs: print an 

rmdel: remove a delta from an 
compare two versions of an 
sccsfile: format of 

undo a previous get of an 
val: validate 

admin: create and administer 
what: identify 

of an SCCS file. 


check file system backup 
/ipmove: start/stop the LP 
uusched: the 

common object file. 

screen image file.. 

clear: clear terminal 
ocurse: optimized 
optimization/ curses: terminal 
scr_dump: format of curses 
display editor based on/ vi: 
inittab: 

terminal session. 

Sharing notification shell 
SCSi: 

scsimap: set mappings for 
half-inch tape. stape: 


rumount: cancel queued remote... . +--+ ses rumount(1M) 


rumountall: mount, unmount .......... rmountall(1M) 
mun a command at low pnonty. .. 2... 6 + ee eee nice(1) 
run acommand immune to. . 2... + +e ee eee nohup(1) 
run commands performed for . . 2... 6 2 eee ee rc2(1M) 
run commands performed to stop... - 6-2 eee rcO(1M) 
run daily accounting. . . 2... ee eee ee ee runacct(1M) 
runacct: run daily accounting. ...-. +++ + ee» runacct(1M) 
runacct, shutacct, startup/ . . 1. 2. 1. 6 6 ee wee acctsh(1M) 
running process by changing/  . . «6 1 ee ee ees renice(1) 
ruptime: display status of . 2. 2 ee ee ew eee ruptime(1) 
ruserok: routines for . . . 6 6 6 0 ee ee ew ew ew ee rcmd(3) 
rwho: who is logged inon  .. 1. e+ ee es ee eee rwho(1) 
rwhod: host status server. . . 6. 1. 2 ee ee ee ee rwhod(1M) 
sal,sa2,sadc: system. 1 2 we ee ew te we ww ww sar(1M) 
sa2, sadc: system activity . 2. 1 1 ee eee et ee sar(1M) 
sact: print current SCCS file . 2. 6 2 ee ee ee eee sact(1) 
sadc: system activity report . 2. 2. 6 ee ee ee ee sar(1M) 
sadp: disk access profiler, 2... 2. 2 eee ee ees sadp( 1M) 
sag: system activity graph. . 2... 6 6 eee ee ee sag(iG) 
sar: sal,sa2,sadc: system .. . 1. 1 6 2 + ee we ew sar(1M) 
sar: system activity reporter, 2... 6 6 ee ee ee ee sar(1) 
sbrk: change data segment .. . . . 6 + + se ee tees brk(2) 
scanf, fscanf, sscanf: convert... 6 6 1 ee ee ee scanf(3S) 
SCANNGE, ie. 4. ee wae ae SG. Ge Se a ee ew ee st eS bfs(1) 
scanning and processing . . 2 2. e+ © © © we ee ewe awk(1) 
scanning and processing... - 2 + + ee ee te ee nawk(1) 
SCCS delta. cdc: change. ww we ew ee ee te ee cdc(1) 
SCCS deéltas;.© 6.6.08. Socket ee a a ee comb(1) 
SCCS file déltas: bss <6 ees Saw es ey Be ee delta(1) 
SCCS file editing activity. . 2... 6 2 1 ee eee ee sact(1) 
SCCS Ble. a. eek ag a ete a a ee: Re a “a SH Gn get(1) 
SCCS fil€s 226-6 6 Awe ee 6S eS Re ee Se a prs(1) 
SCCS Alé.. 24.44 S 6 we a ER rmdel(1) 
SCCS file.secsdif®. 6. 6 kk ae ee ee eS sccsdiff(1) 
SCOS GIG: yer SS eee © EGE RS eS SE SS sccsfile(4) 
SCCS file. unget:: <<.-4 4: 4g. Se HB OS SE Ke ew GS unget(1) 
SCCS file: secs SG er es ES a) Se i LS val(1) 
SCCS files;: 2 -4-e.4 Wo ee Eee De Ss admin(1) 
SCCS Ges. cess we cae Se, Be a a he ee ee what(1) 
sccsdiff: compare two versions. ww ee ee ee ee sccsdiff(1) 
scesfile: format of SCCS file. . 2... 1.2.6 ee ee sccsfile(4) 
schedule. ckbupscd: 2... 1... 1 ee ee ee ckbupscd(1M) 
scheduler and move requests. . . 1... + + se eee Ipsched(1M) 
scheduler forthe UUCP system. .......... uusched(1M) 
scnhdr: section headerfora .... 1. 2. 2 es © we ee scnhdr(4) 
scr_dump: format of curses . ... +--+ se ee scr_dump(4) 
COTOON = i he Bach se Ses BW A Be a ee RU clear(1) 
SCIPEN TUNCHONE. ~ 06 se ki eo: OE See Ne, A ocurse(3X) 
screen handling and . . 1... 2 2 ee ee ew ee curses(3X) 
Screen TAPE Mes. ag. aes. 4. avs Mo oe es a SS scr_dump(4) 
screen-oriented (visual)... 2 1 1 1s ww ee we we ew vi(l) 
script forthe init process. . 2... 1 2 6 ee ee ee inittab(4) 
script: make typescript of . 2... 1 ee ew ee eee script(1) 
script. rffuadmin: Remote File ......-.+... rfuadmin(1M) 
s¢si COntTO) GEVICE., aos eS a scsi(7) 
DCSIGEVICES,. 66-6: 6) ee ee SE SH WEE scsimap(1M) 
SCSI quarter-inch and 2. 1 2 1 2 ee ee ee ee stape(7) 
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devices. 


program. 
string. fgrep: 


grep: 

using full regular/ egrep: 
bsearch: binary 

accounting file(s). acctcom: 
lsearch, Ifind: linear 

hcreate, hdestroy: manage hash 
tdelete, twalk: manage binary 
object file. scnhdr: 

object/ /read an indexed/named 
the object file comment 

/to line number entries of a 

Ao relocation entries of a 

/seek to an indexed/named 
common object/ size: print 


/mrand48, jrand48, srand48, 
section of/ ldsseek, ldnsseek: 

a section idiseek, idniseek: 

a section/ ldrseek, Idnrseek: 
header of a common/ Idohseek: 
common object file. ldtbseek: 
fopendir, readdir, telldir, 
shmget: get shared memory 
brk, sbrk: change data 

to two sorted files. comm: 
multiplexing. 

greek: 

of a file. cut: cut out 

file. dump: dump 

semctl: 

semop: 

ipcrm: remove a message queue, 
semeget: get set of 

operations. 


i_sndudata: 

putmsg: 

send, sendto: 

a group of processes. kill: 
over a connection. t_snd: 
to network hosts. ping: 
nisrequest: format and 
mail. mail, rmail: 

to a socket. 

request. t_snddis: 

line printer. lp, cancel: 
aliases: aliases file for 
program. 

socket. send, 

/receive data or expedited data 
control/ slipd: switched 
/sldetach: attach and detach 


scsi: scsicontrol device. . . 2... ee ee ee eee scsi(7) 
scsimap: set mappings forSCS] .......... scsimap(1M) 
sdb: symbolic debugger. . 2 2 2 2. 1 1 ee ee eee sdb(1) 
sdiff: side-by-side difference . . . 2... 2.2.2 see ee sdiff(1) 
search afileforacharacter ...... 56+ 2+ eee fgrep(1) 
search afileforapattiem. ..... 2.6.2. + ee eevee grep(1) 
search afileforapatiem .. 2... eee eee eee egrep(1) 
search asortedtable. . 2... 1 1 1 ew ee ee ee bsearch(3C) 
search and print process . . 2. - 1 1 ee et ee acctcom(1) 
search and update. . 2. 2... 1 1 ee ee ee ewe lsearch(3C) 
search tables. search, 2s. 6 6 a: ve. cs ee eee hsearch(3C) 
search trees. tsearch,tfind, . 2... 2. 2. ee eee tsearch(3C) 
section headerforacommon ......-..5 2466 scnhdr(4) 
section header ofacommon ......2 +2068: idshread(3X) 
section. mcs: manipulate .... 2... +6. es eee mes(1) 
section of acommon objectf/ . . 6 6 6 1 eee ee Idlseek(3X) 
section of acommon object/ . . 2... 2. 1. ee he ee Idrseek(3X) 
section of acommon object/ . . . 1... + ee ee Idsseek(3X) 
section sizes in bytesof . . 2. 1. ee eee eee size(1) 
Sed: stream ¢dilor. 6s ee a ea we ew sed(1) 
seed48, Icong48: generate/ . 2 2 2 1 1 ee ee es drand48(3C) 
seek to anindexed/named .......- 2. es eee Idsseek(3X) 
seek to line numberentnesof ......+. ++ +65 Idlseek(3X) 
seek to relocation entriesof ........46446.4 Idrseek(3X) 
seek to the optional file ......2+4..24.-8. idohseek(3X) 
seek to the symboltable ofa ........2...- Idtbseek(3X) 
seekdir, rewinddir, closedir:/ . . .. 1... 2 ee directory(3X) 
SCQMENtIMENHET hess oo Gk ES ES shmget(2) 
segment space allocation, . . 2.4... 6 2 ee eee brk(2) 
select or reject bnes common . . . 1. 6 1 ee ee ee comm(1) 
select: synchronous /O . 1... 1 ew ee ee te select(2) 
select terminal filter 2... 1.1. 1 6 ew ew ewe eva greek(1) 
selected fields ofeachline . . 1... 1 1 ee ee te es cut(t) 
selected parts of anobject . 2... 2. 6 ee ee ee dump(1) 
semaphore control operations. . 2... 1.6 6 ee eee semctl(2) 
semaphore operations. . 2... 1 2 + ee ee ee semop(2) 
semaphore set orsharedmemory/ .......+..+. ipcrm(1) 
SEmMaphores:..-6. eis ke ee a a OR semget(2) 
semctl: semaphore control . 2... 1 1 1 ee ee ee semctl(2) 
semget: get set of semaphores. . . ...-..-.-. semget(2) 
semop: semaphore operations. . . . - - + ee ee ee semop(2) 
send adalaunit. . 2... 6 ee ee te ee ewan t_sndudata(3) 
send a message ona stream. . . . 2. 6 1 eee ee putmsg(2) 
send a message to asockel. 2. 6 6 ew ee ee ee send(2) 
send asignal toaprocessOr . . 2. ee ee ee eee kill(2) 
send data orexpedited data 2... 1 1. 1 1 ee ee ee t_snd(3n) 
send ICMP ECHO_REQUEST packets ........ ping(1M) 
send listener service request/ . . 2... 1. ee ee nlsrequest(3n) 
send mail tousersorread . .. 1 1 1 eee ee ew es mail(1) 
send, sendto: send amessage  .. 1... 1 7 we wee send(2) 
send user-initiated disconnect . 2... 2. se eae t_snddis(3n) 
send/cancel requests toanLP .. 2... 2 1 eee ee Ip(1) 
SEMHOMAN.. cbs Ghee: a So We: SO ea ee eG aliases(4) 
sendmail: mail routing... 1.66 2 ee ees sendmail(1M) 
sendto: send amessage toa .. 1... ee ee ee eee send(2) 
sent Overaconnectionn . . 2... 6 eee ee ee t_rcv(3n) 
Serial Line Internet Protocol .........2.... slipd(1M) 
serial lines as network/ . . 1. 1 6 ee ee th ee slattach(1M) 
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serstat: display 

error statistics. 

remote user information 

File Transfer Protocol 
Remote File Sharing name 
mountd: NFS mount request 
named: Intemet domain name 
Remote File Sharing name 
rexecd: remote execution 
rlogind: remote login 

rshd: remote shell 

rwhod: host status 

remote user communication 
telnetd: DARPA TELNET protocol 
Trivial File Transfer Protocol 
uucpd, ouucpd: network uucp 
make typescript of terminal 
buffering to a stream. 
htoascci, _tolower, _toupper, 
IDs. setuid, 

geigreni, getgrgid, peiprnam, 
lgethosthvaddr, gethostent, 
identifier of/ gethostid, 
current host. gethostname, 
goto. 

hashing encryption. crypt, 


/getnetbyaddr, getnetbyname, 


protocol/ /getprotobyname, 
getpwent, getpwuid, getpwnam, 
/getservbyport, getservbyname, 
options on/ getsockopt, 
Ickpwdf,/ getspent, getspnam, 
ume. gettimeofday, 
environment at/ cprofile: 

login time. profile: 

gettydefs: speed and terminal 
group IDs. 


/getutid, getutline, pututline, 
stream. setbuf, 

data in a/ sputl, 
standard/restricted command/ 
Ickpwdf, ulckpwdf: get 
putspent: write 


xstr: extract and 
chkshlib: compare 
mkshlib: create a 
operations. shmctl: 
queue, semaphore set or 
shmop: 

identifier. shmget: get 
nfssys: common 
rfadmin: Remote File 
rfudaemon: Remote File 
dname: print Remote File 


serial port error statistics. 6. 6 6 6 6 6 ee ee ees serstat( 1M) 


serstat: display serial pot 2... 7 7 1 ee ee serstat(1M) 
server. fingerd: . . 2... 6 2 ee ee ee ewes fingerd(1M) 
server. ftpd: DARPA Intemet . . . 2. - - - sees ftpd(1M) 
server master file. rfmaster: . - . - . + + © ee es rimaster(4) 
server, . 2. 2 2 es ee ee © e © @ © © «© « « « Mountd(iM) 
SORVET. os. GS Set hey Be: SS, Ses Se ES we ee named(iM) 
server query. Msquery: . 2. + 6 2 ee ee ee ee nsquery(iM) 
SOLVED. Se 5. bs was aS 6s BE Se rexecd(1M) 
SOLVGE> <7 rags eh ses Sal GE. es Se as a ee rlogind(1M) 
SOIVET. 6 6s. en Ses & ES We ES ee oe rshd(1M) 
SEIVER. o.-B Sid eas Bea ea a SE HE Be ee we rwhod(1M) 
server. talkd: 2 4-6 4S wok a OE eS os AES talkd(1M) 
SCIVEE S36, sissies ae 8 eS LE ee. Be telnetd(1M) 
server. tftpd: DARPA . 1... 2 2 2 ee ee ee tftpd(1M) 
SEIVERE:, 6.05. 8. Hi ee eS Se SN SS. ee Ee uucpd(1M) 
session. script: . 2. 2. 1. 6 ss ee ee eet tw ew script(1) 
setbuf, setvbuf: assign . . 2. 1 6 1 2 ee ee ee setbuf(3S) 
setchrclass: characterf/  . . 1 2 ee ee ete ee ctype(3C) 
setgid: setuser and group... + 6 6 ee ee ee setuid(2) 
setgrent, endgrent, fgetgrent:/ . 2. 2 6 6 6 ee ee getgrent(3C) 


sethostent, endhostent: get/ . . . 2 2. . . . . . gethosthyvname(3) 
sethostid: get/set unique... 1... see eee e gethostid(2) 
sethosiname: get/setnameof .........-. gethostname(2) 
setjmp, longjmp: non-local . . 6. 2 6 6 se ee ee setymp(3C) 
setkey, encrypt: generate 2. 2 6 1 ee ee ee ee crypt(3C) 
setmnt: establish mount table. . . ...- +. se. setmnt(1M) 
setnetent, endnetent: get/ . 2... 1 2 ee ee ee getnetent(3) 
setpgrp: set process groupID. . . .. 2... ++. setpgrp(2) 
setprotoent, endprotoent: get... 2... ee eee getprotoent(3) 
setpwent, endpwent, fgetpwent:/  . . 2... ...-. getpwent(3C) 
setservent, endservent: get/ . . 2. 2. ee 2 we wee getservent(3) 
setsockopt: getandset .. 2. 6 ee ee ee eee getsockopt(2) 
setspent, endspent, fgetspent, . . . . - - + + e+ getspent(3X) 
settimeofday: get/setdateand ......+... gettimeofday(2) 
setting upaCshell 2... 1 1 we eee ee ee cprofile(4) 
setting up anenvironment at . 2... 2 ee ew ee profile(4) 
settings used by geltly. . 2... 2 ee we ee ee gettydefs(4) 
setuid, setgid: setuserand ....... + + 2 ee ee setuid(2) 
setuname: set name of sysiem. ..... ++... setuname(1M) 
setutent, endutent, ulmpname:/ . . . 2... 2 sw ws ~ gemdac) 
setvbuf: assign bufferingtoa .......4....e-s setbuf(3S) 
sgetl: access long integer . . 1... 1 ee ee eee sputl(3X) 
shi ysh? shell Ane se -6eeneece eee eh, Bm ae Se sh(1) 
shadow. /endspent, fgetspent, . . ..... 2... getspent(3X) 
shadow password fileentry, .....- + eee putspent(3X) 
shadow: password file. . . 2. 2 6 2 eee ew eee shadow(4) 
share strings in C programs. ... 1... ee ee ee ee xstr({1) 
shared libraries toolh . 2 1 1 1 1 ew ee eh we ew chkshlib(1) 
shared Library: <6. 6.56 6 6 6 dah, we OR: a NS mkshlib(1) 
shared memory control . 2... 1 1 we te ew we shmctl(2) 
shared memory ID. /famessage ..... 2-22.22 iperm(1) 
shared memory Operations, . . 2... 2 eee ee es shmop(2) 
shared memory segment .......- +++ ees shmget(2) 
shared NFSsystem calls. 2... 1. 1. 2 ee ee eee nfssys(2) 
Sharing administration. .......-+ +5. 2s. tfadmin(1M) 
Sharing daemon process. . . . . 2-1 + ee ee rfudaemon(1M) 
Sharing domain and network/ . 2... - 2 eee dname(1M) 


- [xiv - 


rfstop: stop the Remote File 
rfpasswd: change Remote File 
file. rfmaster: Remote File 
nsquery: Remote File 

script. rfuadmin: Remote File 
unadvertise a Remote File 
/mount, unmount Remote File 
ristart: start Remote File 
mapping. idload: Remote File 
remd: remote 

with C-like syntax. csh: a 
system: issue a 

cprofile: setting up a C 

shi: 

shutacct, startup, tumacct: 
File Sharing notification 

rshd: remote 

command programming/ sh, rsh: 


operations. 

segment identifier. 
operations. 

mounts. 

fprdaily, prtacct, ranacct, 
system, change system state. 
full-duplex connection. 
program. sdiff: 

abort: generate a 

sigpause: signal/ sigset, 
sigset, sighold, sigrelse, 
login: 

sigrelse, sigignore, sigpause: 
pause: suspend process until 
what to do upon receipt of a 
of processes. kill: send a 
ssignal, gsignal: software 
/sighold, sigrelse, sigignore, 
signal/ sigset, sighold, 
sigignore, sigpause: signal/ 
lex: generate programs for 
generator. rand, srand: 

atan, atan2:/ trig: 

functions. 

fsize: report file 

get descriptor table 

object/ size: print section 
detach serial lines as/ 

serial lines as/ slattach, 

an interval. 

interval. 

documents, view graphs, and 
typesetting view graphs and 
linker, load socket/ 

Intemet Protocol control/ 
current/ ttyslot: find the 
spline: interpolate 

sno: 

bind: bind a name 1o a 


Shanng environment. . 2... 1 1 2 ee ee ee rfstop(1M) 
Sharing host password. . . 2. 1 7 2 ee ee ee rfpasswd(iM) 
Sharing name servermaster . 2... 2... - eee rfmaster(4) 
Sharing mame server query. . . . 2... 2. ee ee nsquery(1M) 
Sharing notification shell . 2. 2. 1. 1 2 ee eee rfuadmin(1M) 
Sharing resource. unadv: ww 1 we ee ee ee unadv(1M) 
Sharing (RFS) resources. . . . 2-2 ee ew eee rmountall(1M) 
SHANE, 4 5 iow Ge SE ee we rfstart(1M) 
Sharing user and group... 1.6 ee ee ee idload(iM) 
shell command execution. . ... 2. 2. 6 + eee eee romd(1) 
shell (command interpreter) . . 2... 2 7 ee ee eee esh(1) 
shell. command. 6 6-60.64. @os).40@ Wie we ES He system(3S) 
shell environment atloginf . .. 2... eee eee cprofile(4) 
shell layermanager. . . 2... 1 1 2 we ew ee we ee ww shl(1) 
shell procedures for/ /nmacct, ... 1... 2586. acctsh(1M) 
shell script. (Remote... 2.1.2 2 2 eee eee rfuadmin(tM) 
shell S€rver. <6)... gfe ee ww a we we Se rshd(1M) 
shell, the standard/restricted . . . . 1. 2. 2 ee ee we wwe sh(1) 
shl: shell layermanager. . . . 2... 1 1 1 2 ee wee shi(1) 
shmctl: shared memory control . 2... 6 2 1 ew eee shmctl(2) 
shmget: get shared memory ....... 2-2 eee shmget(2) 
shmop: shared memory .......... ++ - - - shmon(?)} 
showmount: show all remote... . 1. 6 se ees showmount(1lM) 
shutacct, startup, tumacct:/ 6 wwe we ee te acctsh(1M) 
shutdown, halt: shutdown ........242.-. shutdown(1M) 
shutdown: shut down partofa .... 2... ewe. shutdown(2) 
side-by-side difference. .. 2... 6 ee eee eee sdiff(1) 
SIGABR Dev. 2.4504" oe we. ha Cera wae B.S es es We abort(3C) 
sighold, sigrelse, sigignore, .. 2... 2.2.1 2 ee ae sigset(2) 
Sigignore, sigpause: signal/ . . . . . 2... eee eee sigset(2) 
SIGN OM. aoe Se ek es Se ws oe A eS a eae login{1) 
signal management. /sighold, . . . . . 2. 2. 2 ee ee Sigset(2) 
SIGNALS. eco: 4h ee Se: toes we, EE fe, Ome ee ASE, pause(2) 
signal. signal: specify  . 2. 1. 6 ee ee ee ee es signal(2) 
signal to aprocess Oragroup ... 2... 6 eee ee ewe kill(2) 
SIQRMIG, =k eb Wiel wo cde BE eto Wek ee ssignal(3C) 
Sigpause: signal management. .... 2. 1. 6 ee eee sigset(2) 
sigrelse, sigignore, Sigpause: . 2... 1 eee ee ee sigset(2) 
sigset, sighold, sigrelse, . . ... 2. 2. 2 ee ee eee sigset(2) 
simple lexical tasks. 6 1 6 we ew ee tw ee te lex(1) 
simple random-number ..... 2... 6-56 ee ees rand(3C) 
Sin, COS, tan, aSIN, ACOS, www kt ek ts tng(3M) 
sinh, cosh, tanh: hyperbolic ........2.4-20842-.- sinh(3M) 
SITs. eka) ite a ee EES: tS ee es ee a ae es ee fsize(1) 
size. getdtablesize: . 1. 1... 6 2 ee ee ew getdtablesize(2) 
sizes in bytes of common ........54-4 4246 eae size(1) 
slattach, sldetach: attach and . . 1... 1. +e eee slattach(1M) 
sldetach: attach and detach... 1... 1. ee ee slattach(1 M) 
sleep: suspend execution for . 2... 2... 2 2 eee sleep(1) 
sleep: suspend execution for . . . 2. 2 6 2 ee eee sleep(3C) 
slides. mmt, mvt: typeset 2 2 6 6 2 ew eee we ee mmt(1) 
slides. fmacro package for . . - 2... 21. + ee wea mv(5) 
slink, ldsocket: STREAMS .. 1... 2.1 se es ewes slink(1) 
slipd: switched Serial Line . 2... 1 2 2 ee eee slipd(1M) 
slot in the utmp file ofthe .......2...0086-4 ttyslot(3C) 
SMOOUL CUIVE: <a 6 A Sw a ee Se spline(1G) 
SNOBOL interpreter. . 2. 2 6 1 7 ee ee ee ee sno(1) 
SOCKEL, 45 2 eh es te A Ae SS So ee 8 bind(2) 
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Idsocket: STREAMS linker, load 
initiate a connection on a 
communication. 

listen for connections on a 
getsockname: get 

receive a message from a 
sendto: send a message to a 
get and set options on 
ctinstall: install 

interface. lo: 

ssignal, gsignal: 

qinstall: install and venfy 
sort: 

qsort: quicker 


tsort: topological 

or reject lines common to two 
bsearch: binary search a 
object file. list: produce C 
brk, sbrk: change data segment 
funexpand: expand tabs to 
terminal. ct: 

the/ tapednives: tape drive 
cfume: language 

fspec: format 

receipt of a signal. signal: 
/set terminal type, modes, 
/set terminal type, modes, 
used by getty. gettydefs: 
spelling/ spell, hashmake, 
spellin, hashcheck: find 
curve. 

split: 

csplit: context 

efl files. fsplit: 

uucleanup: uucp 

Ipr: line printer 

Ipadmin: configure the LP 
output. printf, fprintf, 
integer data in a/ 

power,/ exp, log, log10, pow, 
exponential, logarithm, power, 
generator. rand, 

/nrand48, mrand48, jrand48, 
input. scanf, fscanf, 

signals. 

package. stdio: 
communication/ stdipc, ftok: 
sh, rsh: shell, the 

half-inch tape. 

and output. rsterm: manually 
rfstart: 

operating system for/ 

and/ Ipsched, Ipshut, lpmove: 
/prtacct, runacct, shutacct, 


useful with graphical/ 
Stat: data retumed by 


socket configuration. slink, . . . 2... 6 ee ee eee slink(1) 


SOckEeL CONNEC? 6. 6.5, Bia, Ao-SS  e e  we  e connect(2) 
socket: create anendpoint for .. 2... 2. ee eee socket(2) 
socket; listens. 5:4: -be"as eS Baw Fa ae Se aS listen(2) 
SOCKEUHIAMG. <5. es oo ic wi Sas Ve 5 ce getsockname(2) 
socket. recv,recvfrom: . 2... 6 6 ee ee te ee ee recv(2) 
SOCKEL SONG). ©. -ae ea h6 a GW Lae a. oe Be send(2) 
sockets. /setsockopt: 2... 6 2 ee ee ee es getsockopt(2) 
SORWAIC::.; 6050 Se, BE as: BS ES Ee ctinstall(1) 
software loopback network 2... 1 6 eee et ee ees lo(7) 
software signals. . 2. 2. 2. 2 6 2 ee eh ew we ee ssignal(3C) 
software using the mkfs(1)/ . . . . 2. 2 ee ee ee qinstall(1) 
sort and/or merge files; . . 2... 6 ee te we ew ee ee sort(1) 
BOTS 26-05: aes 1 ae a a, Bie ee qsort(3C) 
sort: sort and/or merge files. . 2. 2. 2. 2. 2 ee ee ee ee sort(1) 
‘We Go 6.6 BS RO Se SR LS Ee Se ee RS tsort(1) 
sorted files. comm: select . 2... 1. 2. 6 2 6 ee ew comm(1) 
Sorted table... 160-4: See ce ee a et Se bsearch(3C) 
source listing fromacommon ..... 6 2 2-6 ee ee list(1) 
space allocation, 2... 26 2 ee ee ee we te ee ww brk(2) 
spaces, and vice versa. . 2 6 2 ee ee ee ew ee expand(1) 
spawn getty toaremote . 2. 2 1 ee ee ee te ts ct(iC) 
specific information used by... 1 es 1 se ee tapedrives(4) 
Specific siNNgs. <6 ve: Ss. Gecko B.S OBS Gr a LES cftime(4) 
specification in text files. . 2. 2 6 2 eee ew ee eee fspec(4) 
specify whattodoupon .. . 2... ee ee ee ew signal(2) 
speed, and line discipline. . . 2... 1 ee ee eee getty(1M) 
speed, and line discipline. ......- ++ 2 ees uugetty(1M) 
speed and terminal settings . .. 1... + see eee gettydefs(4) 
spellin, hashcheck: find . .. 2. 1 ee ee eo ee wee spell(1) 
spelling errors. fhashmake, . . . 2. 2 ee 2 ee ee spell(1) 
spline: interpolate smooth ......-+ +. eee - spline(1G) 
split a file into pieces. . . 2... 2 ee ee ee ee split(1) 
SOMES oS es pk es Sa ers; SS we Re SS esplit(1) 
split FORTRAN, ratfor,or . 2. 2 6 ee ee ee we fsplit(1) 
spool directory clean-up. . 2... 2 6 ee ee ee uucleanup(1M) 
SDOOIET$ 6:55: ae oe ee oe ee Se Ipr(1) 
spooling system. . . 2. 6 ee ee ee ee es Ipadmin(1M) 
sprintf: print formatted . .. 2... 2.2 6 2 ee ewe printf(3S) 
sputl, sgetl: accesslong . . . . «© © ee ee ee ww sputh(3X) 
sqrt: exponential, loganthm, ..........246-. exp(3M) 
square root functions. /sqrt: . . 2... 6 + 5 2 we ee exp(3M) 
srand: simple random-number ...........--. rand(3C) 
srand48, seed48, lcong48:/ 2... 2 1 ee ee eee drand48(3C) 
sscanf: convert formatted ... . 1... 1 ew ee scanf(3S) 
ssignal, gsignal: software ......... +446. ssignal(3C) 
standard buffered input/output ............ stdio(3S) 
standard interprocess . 2... 1... 2 eee eeu stdipc(3C) 
standard/restnicted command{/ ..........6e+82e8-8 sh(1) 
stape: SCSI quarter-inch and . . 1. 1. 1 1 ee ee es stape(7) 
start and stop terminal input ......... +a. rsterm(1M) 
start Remote File Sharing. ......... sees rfstart(1M) 
starter: information aboutthe ........+4+s46-. starter(1) 
start/stop the LPscheduler .........4.24.-. Ipsched(1M) 
startup, tumacct: shellf/ 2... 1. 2. 7 2 2 ee wees accish(1M) 
stat, fstat: get file status. . . 2. 1 1 ee we ee ew te stat(2) 
Stat: statistical metwork . 2... 1 ee ee ew ew ee stat(1G) 
Stat system Calle. 2-6. 8 deck ee ORS we EE GE stat(5) 
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a 


system information. 

with graphical/ stat: 

ff: file name and 

nfsstat: Network File System 
display serial port error 
ustat: get file system 

fsstat: report file system 
/extract error records and 
Ipstat: print LP 

feof, clearerr, fileno: stream 
control. uustat: uucp 
communication facilities 
netstat: show network 
network. ruptime: display 
Pps: report process 

rwhod: host 

stat, fstat: get file 
input/output package. 
interprocess communication/ 


wait for child process to 
rsterm: manually stan and 
rcO: run commands performed to 
environment. rfstop: 
nextkey:/ dbmiunit, fetch, 
messages. 

strcmp, stmcmp,/ string: 
/strcpy, stmcpy, strlen, 
cleanup program. 

/strcat, strdup, strmcat, 
/strncat, strcmp, stmcmp, 
/strrchr, strpbrk, strspn, 
stmcmp,/ string: strcat, 

i sed: 

fflush: close or flush a 

fopen, freopen, fdopen: open a 
reposition a file pointer in a 
get character or word from a 
gelmsg: get next message off a 
fgets: get a string from a 

put character or word on a 
puimsg: send a message on a 
puts, fputs: put a string on a 
setvbuf: assign buffering to a 
feof, clearerr, fileno: 

‘routines for returning a 
rexec: retum 

push character back into input 
commands. 

open any minor device on a 
program. strclean: 

streir: 

event/ log: interface to 
multiplexing. poll: 

streamio: 

slink, Idsocket: 

Interface cooperating 
Interface read/write interface 


Statfs, fstatfs: pet fle: . 2. 20:20 5 wt ws were ee) ap Ae oe statfs(2) 
statistical network useful . . 2... 1 1 we ee ee stat(1G) 
statistics forafilesystem. . 2... 1... ee ee eee ff(1 M) 
SAI SHCS:. ae: ee de. es es os ee SS Ace SE OS SS nfsstat(1M) 
Statistics.’ SErstals 4.06: 6: Ww a ew Se HH ES serstat(1M) 
SIQUSNCS Sos ws. Ke. Se ae Ea OBE eo et A ustat(2) 
SIQENS.  -e- ak e ee, S w e ,  e fsstat(!M) 
status information from dump. ... . .....+.- errdead(] M) 
Status information. . 2... ee ee we ee ee ee Ipstat(1) 
status inquiries. ferror, . . . 2. 2 2 2 ee ew ee ew ferror(3S) 
status inquiry and job). © ww ew we we te et uustat(1C) 
status. /report inter-process  . 2. 1 6 1 ee ee eh ee ipes(1) 
SEQtIG ie fat eee Bs ae a la i a a ee netstat(1) 
status ofnodesonlocal 2... 1 2 ee ee ew ee ee rupume(1) 
SIQNIS, <5. 5 1e5G eH Agent Bie ain wes SG. ces hag Be ee ps(1) 
StANIS:SCTVEL:. “ho we Ho ew a rwhod(1M) 
SUMUISS.; -S* han Ser Be ye oe a te I ec ae et stat(2) 
stdio: standard buffered . .... 2. 2. 2 ee ee wee stdio(3S) 
stdipc, fiok: standard 6 ww wee ee ee te stdipc(3C) 
SIME SEL TING: - oc. oe Sy ee 0S Se Sow a es Sw ES stime(2) 
stop or terminate. wall: 2. 6 6 6 6 se te te ee ee wait(2) 
slop terminal input and/ . . . . . 6 2 ee ee ee rsterm(1M) 
stop the operating system. . . - 2. + 6 se eee eee rc0(1M) 
stop the Remote File Sharing .......- +2. rfstop(1M) 
store, delete, firstkey, . 2... 2 6 6 eee ee ees dbm(3X) 
strace: print STREAMS trace . . 1... 1. ee eee strace(1M) 
Strcal, strdup, strmcat, 2. 6 6 ee ew ee ee ee string(3C) 
strchr, strrchr, strpbrk/ 6 6 6 6 ewe ee ee ee string(3C) 
strclean: STREAMS errorlogger .. ......-.-: strclean(1M) 
stremp, stmemp, strepy/ .. 1... 2 6 ee ee ee string(3C) 
Strcpy, stmepy, strlen/ . 2. 6 2-2 ee ee eee string(3C) 
strcspn, strtok: string/  . . 1. 1 eee ee ee ew ww string(3C) 
strdup, stmcat, stroemp, . . . 6 6 6 6 we ee ee string(3C) 
Stream GGUOL. - > Sos. as Kee Ce a we oe re sed(1) 
Stresins fClOSE,. 24--6: 95 8, iow wwe: GPa Re aw Aes fclose(3S) 
GUS ANG. ho a 5 ee tee BS as, Ee NS te cho SE We fopen(3S) 
stream. fseek, rewind, ftell: . ......-+.-+-se-e fseek(3S) 
stream. /getchar, fgetc, getw: . . 2. 2 6 ee ee ee getc(3S) 
SUNG AN s d2 ds ee OE ce, ey SR a a getmsg(2) 
StregIn; 2618, <a. sa: ree we ee eS he, oS ee gets(3S) 
stream. /putchar, fputc, putw: . 2... 2 6 2 ew ees putc(3S) 
SIQCSIN: v5. Gok va: See See ed er SS Se ew RE putmsg(2) 
SiESIN. 6. oa os a ae A eS we ESS puts(3S) 
Stream: setbUl, sea ee ee OR SOR SK ew setbuf(3S) 
stream status inquinies. . 2... ee ew ee ee ee ferror(3S) 
stream to aremote command. ...... +++ eee remd(3) 
stream to aremote command. .......+ +2886 rexec(3) 
stream. ungetC: 6 6 6s te te te te ee ungetc(3S) 
streamio: STREAMS ioctl . . 1... 1 1 ee ee es streamio(7) 
STREAMS driver. clone: 2. 2 1 1 1 eee ew et clone(7) 
STREAMS errorlogger cleanup .......+.-+-- strclean(1M) 
STREAMS errorlogger daemon. . .......+-+--. strerr(1M) 
STREAMS errorlogging and . . .. 1... ee ee eee log(7) 
STREAMS input/output . 2. 2 6 6 1 eee ee ee poll(2) 
STREAMS ioctl! commands. .... 2. 6 ee ee ee streamio(7) 
STREAMS linker, load socketf ..... 2.2.4 ee a slink(1) 
STREAMS module. /Transport ....... 2.2.5 timod(7) 
STREAMS module. /[ranspot . . 2... 1. 7 ew ee tirdwr(7) 
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sxt: 

strace: print 

daemon. 

long integer and base-64 ASCII 
convert date and time to 
floating-point number to 
search a file for a character 
gps: graphical pnmitive 
gets, fgets: get a 

puts, fputs: put a 

bemp, bzero: bit and byte 
strspn, strcspn, strtok: 
number. strtod, atof: convert 
strtol, atol, atoi: convert 
cftime: language specific 
text strings in a file. 

extract the ASCII text 

xstr: extract and share 
number information from a/ 
information from a/ strip: 
/stmemp, strcpy, strncpy, 
string: strcat, strdup, 
/strdup, stmcat, strcmp, 
/strcmp, stmecmp, strcpy, 
/strlen, strchr, strrchr, 
/strncpy, strlen, strchr, 
/strchr, strrchr, strpbrk, 

to double-precision number. 
/strpbrk, strspn, strcspn, 
string to integer. 

processes using a file or file 
t_alloc: allocate a library 
t_free: free a library 
terminal. 

another user. 

firstkey, nextkey: database 
dbm_clearerr: database 
plot: graphics interface 
/same lines of several files or 
count of a file. 

du: 

accounting/ acctcms: command 
base. mpc: 

sync: update the 

sync: update 

inetd: internet 

/file for inetd (internet 

su: become 

interval. sleep: 

interval. sleep: 

pause: 


swap: 

swab: 

interface. 

Protocol control/ slipd: 
file. 


STREAMS multipiexor, 2... 2 6 ee ee et ee ee ee sxt(7) 
STREAMS trace messages. . . . 2... + + - strace(1M) 
strerr: STREAMS error logger... - .- - + - ee es strerm(1M) 
string. /l64a: convert between «2. ee ee eee ee a641(3C) 
string. /ascftime, tzset: 2. 6 6 ee ee ee ee es ctime(3C) 
string. /fcvt, gcvt: convert . 1 2 ee ee ee ee ee ecvt(3C) 
string. fgrep: 6 6 we ee ee ee ee ee fgrep(1) 
string, format of graphical/ . . 2... 6 ee ee ee ee gps(4) 
string fromastream. . . 2. 6 ee ee ee ee eee gets(3S) 
string onastream. . 2. 6 1 ee ee ee ee ee es puts(3S) 
string operations. boopy, ... - - 2+ +e ee eee bstring (3) 
string operations. /strpbrk, . 2... - 6 6+ se ee string(3C) 
string to double-precision  . . . 2 ee ee ee ee strtod(3C) 
string tointeger. . 2. 2. 2 + se ee et ee we eee strtol(3C) 
SINGS; oa a: BO a SO Se we Oa eS Ge cfume(4) 
strings: extract the ASCIT . 2. 2 1 2 6 2 ee ee ee strings(1) 
strings in a file. strings: . . 2. 2 6 ee ee ee ees strings(1) 
strings inC programs. . . 2. 6 ee ee ee ee eh ee xstr(1) 
strip: strip symbol and line... . - 6 6 + ee eee strip(1) 
strip symbol and line number... . 2. +. - 2 se ees strip(1) 
strlen, strchr, strrchr/ ww ww we ee te te ee stnng(3C) 
strncat, strcmp, stmcmp/ . . 1. 6 6 ee ee ee string(3C) 
stmcmp, strcpy, simcpy/ . 2. - 6 6 1 6 ee ew ee es string(3C) 
stmcpy, strlen, strchr/ 2. ww ee ew ee ee es string(3C) 
strpork, strspn, strespn,/ . 2 we ee ee ee ee string(3C) 
strrchr, strpbrk, strspn/ 2 6-6 ee ee ee wee string(3C) 
strspn, strespn, strtok:/  . 6 6 6 ee ee ee ee string(3C) 
strtod, atof: convert string . . 2. 2 6 6 ee ew ew ee strtod(3C) 
striok: string operations. 2... 6 6 ee ee ee ee string(3C) 
strtol, atol, atoi: convert . . 1 2 1 ee ee ew ew strtol(3C) 
structure. fuser:identify . . . 1. 1. + ee e+ ee ee fuser(1M) 
StniChITe.: 5. Gs he ee Ses Ge SS t_alloc(3n) 
SUNICUIIG. 6 a. eh OE eR a ee we ee t_free(3n) 
stty: setthe options fora) w/w wwe tt tee he stty(1) 
su: become super-useror .. 2. 2 + es ee ee eee su(1M) 
subroutines. /store,delete, . 2... 6 6 ee ee ee ee dbm(3X) 
subroutines. /dbm_error, . 2. 2. 1 6 6 2 ee we we ee ndbm(3X) 
SUDOULINIES. 5) kee A EO EH plot(3X) 
subsequent lines of one file. . 2. 2 2 2 ee ee ee ee paste(1) 
sum: print checksum and block . . 2... ee ee eee sum(1) 
summarize disk usage. . 2... 6 6 1 eo ee we ew ww du(1M) 
summary from per-process . 2. 2. 6 ee ee ee ee acctcms(i1M) 
Sun rpc program number data . . 2. 2. 6 ee ee ee ew es rpc(4) 
super block... eb. ee ee ee ae eae sync(1M) 
super block; 64 6 a 06 Bee ee ee ea sync(2) 
SYSUDET-SCIVER S26. co! BS 4S SS Oe! NE See tS inetd(1M) 
*““super-server’’), 2. 6 1 ee ee ee th ee ww inetd.conf(4) 
super-user or another user. 2 2. 1 2 2 ee ee ew ee su(1M) 
suspend execution foran . «6 1 6 ee ee ee ee sleep(1) 
suspend execution for 2... 6 ee eee ee ew sleep(3C) 
suspend process until signal, 2. 2 2 ew ee ee ee pause(2) 
swab: swap bytes. ... 2.2 - 2 2 ee ee te wt ewe swab(3C) 
swap administrative interface. . 2... 1 ee ee eee swap(1M) 
Swap Dy(eS. 2. 6.05 fa-:6. Oe a eS a) Sh ce Se te swab(3C) 
swap: swap administrative .. . 1. 2 es ee ee es swap(1M) 
switched Serial Line Intemet ............ slipd(1M) 
swrite: synchronous writeona .. 1... ee ee ees swrite(2) 
sxt: STREAMS multiplexor, 2. 2 1 2 1 we eee ee sxt(7) 
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information from/ strip: strip 
file/ idgetname: retrieve 

name for common object file 
object/ /compute the index of a 
Idtbread: read an indexed 
syms: common object file 
object/ Idtbseek: seek to the 
unistd: file header for 

sdb: 

common CTIX system terms and 
mkdbsym: load 

symbol table format. 


{correct the time to allow 
update: provide disk 

t_sync: 

select: 

swrite: 

interpreter) with C-like 
definition. 

error/ perror, ermo, 
information. 

Tequests. 

perror, ermo, sys_errlist, 
shutdown, halt: shut down 
binary search a sorted 

for common object file symbol 
/compute the index of a symbol 
file. /read an indexed symbol 
common object file symbol 
master device information 
mntiab: mounted file system 
idtbseek: seek to the symbol 
/dtoc, ttoc, vtoc: graphical 
remotely mounted file system 
I/O Processor configuration 
setmnt: establish mount 
getdtablesize: get descriptor 
classification and conversion 
tbl: format 

hdestroy: manage hash search 
manipulate the routing 

tabs: set 

expand, unexpand: expand 
request. 

Clags: create a 

a file. 

talk: 

communication server. 
structure. 

trigonometric/ trig: sin, cos, 
sinh, cosh, 

V/TAPE 3200 half-inch 

set drive parameters for 
information used/ tapedrives: 
tsioctl: facilitate usage of a 
Hewlett-Packard 2645A terminal 


symbol and ine number... 1. 1 ee ew ee ees strip(1) 
symbol name forcommon object... ...... Idgetname(3X) 
symbol table entry. /symbol .......... Idgetname(3X) 
symbol table entry ofacommon ......... ldtbindex(3X) 
symbol table entry of acommonf/ ......... Idtbread(3X) 
symbol table format. ..... 4.5.4.4. + ++ + . syms(4) 
symbol table ofacommon .......- +e eee Idtbseek(3X) 
symbolic constants. 6 6 ew ee et ee te unistd(4) 
symbolic debugger. . 2... 2 1 1 ee ee ee ee ew sdb(1) 
symbols. /definttons of . . 1... - 2 ew ee ewe glossary(1) 
symbols in kernel debugger. . . ......-... mkdbsym(1M) 
syms: common object fle ....- 1-56 e+e eee syms(4) 
sync: update super block. 2. 2 6 6 1 wee ee ee sync(2) 
sync: update the super block. .....- 1... - see sync(1M) 
synchromzation ofthe system/  ........4.4.-. adjume(2) 
SYNGHONIZANON. 6s eo a ee update(1M) 
synchronize transport library. . . 2. 2... ee eee t_sync(3n) 
synchronous I/O muluplexing. . . . 2... 1 2 eee select(2) 
synchronous wnte onafile. .... 1.2. 2. ee eee swnite(2) 
syntax. csh:ashell (command ....... 2.26 ee ae csh(t) 
sysdef: output syslem . 2. 1 1 we ee ee ee sysdef(1M) 
sys_errlist, sys_nerr: system ......-- - =: - = perrorQC) 
sysfs: get file systemtype . . 1... 2 1 6 0 ee we wee sysfs(2) 
syslocal: special system .. 2. ee 2 + ee se ee sySlocal(2) 
sys_nerr: systemerror/ . . 2. 1 6 ew ee eh ee es perror(3C) 
system, change system State. ......-+ ee. shutdown(1M) 
table. bsearch: 6 6 6 bw OS eB Se ew bsearch(3C) 
table entry. /symbolname ........... Idgetname(3X) 
table entry of acommon objectYy ww ww we ee Idtbindex(3X) 
table entry of acommon object .......4..--. Idtbread(3X) 
table foiriat.-Syinis. ce... sed ew ew ee a We syms(4) 
(ABIO. ASLETS 05. Sk ke eo Se ee KR Oe ee master(4) 
Nabe. 0.6. Ge, & wee. Se Gs SR SS. Sh wt SR mnttab(4) 
table of acommon object fille. . . ......... Idtbseek(3X) 
table of contents routines. . . 1... 6 ee ee wee toc(1G) 
taBIG“PMUADS ia oar, Ses ee Re ke Se rmtab(4) 
table: wiab: Remote: 464: so-so ko a ee we a rtab(4) 
USD ee nee eet ee te Ree Be Girt oS setmnt(1M) 
table S176 4: <6. a: 6. Be i ee eek A a getdtablesize(2) 
tables. /generate character . . 2... 1. 2 ee we eee chrtbl(i M) 
tables for nroffortroff, . . 2... 1 eee we ee ee ee UIT) 
tables. hsearch, hcreate, . . . 2... ee ee ees hsearch(3C) 
tables. route: manually ........506 88658 route(1M) 
tabs onaterminal. . . 2... 1 1 ew ee ee te tw tabs(1) 
tabs to spaces, and vice/ ww ww ee ee ee ee expand(1) 
t_accept: acceptaconnect ..........4.. t_accept(3n) 
Ong 6 Fle ote. 2a ee as Ws se Ee eae ae ctags(1) 
tail: deliver the last partof . . 1... 1... 2 eee eee tail(1) 
talk toanotherisers.. 6-4. ae hm, He Be talk(1) 
talkd: remote user . 1 1 1 1 ee ee we eh ee ee talkd(1M) 
t_alloc: allocate alibrary . 2... 2. 1. ee ew wee t_alloc(3n) 
tan, asin, acos, atan, atan2: . . 1... 1 1 2 ewe wee tng(3M) 
tanh: hyperbolic functions. .........se+:. sinh(3M) 
tape controller. fInterphase . 2 1. 2 6 we ee ee ee ipt(7) 
tape controllers. tapeset: «6 1 6 6 ee eee es tapeset(1M) 
tape drive specific 6 6 6k ee ee ee we ee tapedrives(4) 
LUPE GIVE... ee 6. BR LO es tsioctl(1) 
tape file archiver. hpio: . 2. 2. 2 1 6 ee ee ee ee hpio(1) 
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Lar: 

recover files from a backup 
tio: 

gic: interface for QIC 
quarter-inch and half-inch 
specific information used by/ 
for tape controllers. 


programs for simple lexical 
transport endpoint. 

deroff: remove nroffftroff, 

or troff. 

endpoint. 

connection with another/ 
Control Protocol. 

/hpd, erase, hardcopy, tekset, 
search trees. tsearch, tfind, 
terminal download. 


gdev: hpd, erase, hardcopy, 
4014: paginator for the 
initialization. init, 
directory: opendir, readdir, 
telnetd: DARPA 

telnet: user interface to 
TELNET protocol. 

server. 

temporary file. tmpnam, 
tmpfile: create a 

tempnam: create a name fora 
terminals. 

term: format of compiled 
terminfo/ captoinfo: convert a 
data base. 

for the Tektronix 4014 
functions of the DASI 450 
interface. tiop: 

termcap: 

terminfo: 

console: console 

cl: spawn getty to a remote 
generate file name for 

tdl, gtdi, ptdl: RS-232 
terminal interface, and 
greek: select 

/tgetstr, tgoto, tputs: 
/manually start and stop 
terminal/ tset: set terminal, 
termio: general 

tty: controlling 

dial: establish an out-going 
list of terminal types by 
database. tput: initialize a 
clear: clear 

optimization package. curses: 
script: make typescript of 
getty. gettydefs: speed and 
stty: set the options for a 


tape file archiver. 2. 2 6 6 ee ee ee ee ee ee tar(1) 
tape: frees 264i eens ©. Be RS RE ch RS. frec(1M) 
tape io filter, 2 6 6 6 ee ee ee ee uo(1) 
(ONG: sk oe ee wR ee qic(7) 
tape. stape: SCSE 2 6 6 6 ee ee ee ee ee stape(7) 
tapedrives: tape drive . 2. 2 6 ee ee ee es tapedrives(4) 
tapeset: set drive parameters . . 1. - + + se ee tapeset(] M) 
tar: tape file archiver, 2 2. 2 6 se ee eee eee te tar(1) 
tasks. lex: generate . 2. 1 2 2 ee ee ee th we ee ws lex(1) 
t_bind: bind an addresstoa . . 2 2 ee eee ee t_bind(3n) 
tbl, and eqn constructs, 6 6 6 6 ee ee ee ee es deroff(1) 
tbl: format tables fornroff . . . 1... 2. 2. 6 2 we eee tbl(1) 
t_close: close atransportt «ww ee ee ee ee t_close(3n) 
t_connect: establisha . 2... 1 2 ee ee ee t_connect(3n) 
tcp: Intemet Transmission . 2. 6 6 ee ee eee eee tcp(7) 
td: graphical device routines/ 6 «we ee ee ee es gdev(1G) 
tdelete, walk: manage binary .......-.+-++.-. tsearch(3C) 
td], gtdl, ptdl: RS-232, 2 6 ww ee ee ee ee tdl(1) 
tee: pipe fitting, 2. 2. 2. 2 2 ee ee ee ee we ee ww tee(1) 
tekset, id: graphical device/ 2 1. 2 1. 1 ee ee ee es gdev(1G) 
Tektronix 4014 terminal. . 2. 1 2 6 0 ee ee ew ee 4014(1) 
telinit: process control =. 6 we ee ee ee we es init(1M) 
telldir, seekdir, rewinddir/ . 2... 1 +e ee ee directory(3X) 
TELNET protocol server. 2... 2 ee ee ee eee teinetd(1M) 
TELNET protocol, . 2.2... 6 ee ee eee wees telnet(1) 
telnet: user interfacetO 2. 1 we ee ew eh we we ee telnet(1) 
telnetd: DARPA TELNET protocol ........-., telnetd(1 M) 
tempnam: createaname fora .... + ee + eee tmpnam(3S) 
temporary file. 2. 2 1 0 ee ee ee ee ee tmpfile(3S) 
temporary file. tmpnam, . . 1... . 6 + ee ee tmpnam(3S) 
term: conventional names for . . 2... 2 2 2 ee ee term(5) 
termites. a da SG ee eS IS aS See term(4) 
termcap description inloa... ++ ee ee eee captoinfo(1M) 
termcap: terminal capability ......+-+..e-s termcap(4) 
terminal. 4014: paginator «ww ee ee ee ee es 4014(1) 
terminal. 450: handle special . 2. 2 ee se ee ees 45Q(1) 
terminal accelerator . 2... 1 6 2 + ee ee we we ew tiop(7) 
terminal capability database. . . . . - + es se eee termcap(4) 
terminal capability database. .. . 2... +e ees terminfo(4) 
HOPINIAL ac hick? Moe eS, A: es Be console(7) 
terminals. 6 <6 ae ie ae WH OR EO Ee ct(1C) 
terminal. ctermid: . .. 1.5 5 2 ee ee ew wee ctermid(3S) 
terminal download. . . . 2... + 6 1 es ee we we ewe tdl(1) 
terminal environment. . . 1... 6 ee ee we we ee tset(1) 
fetmninial (teh. 6. 4, 6c a ae Be de a Ke Be See greek(1) 
terminal independentf  . . 2. ee ee ee ew otermcap(3X) 
terminal input and output. 2... 2. 2 ee ee ee rsterm(1M) 
terminal interface,and ... 1.6 1 se se ee eee tset(1) 
terminal interface. . . 2... 2 1 se et ewe wees termio(7) 
terminal interface. . . 2... 6 1 ew ee ee ee eee tty(7) 
terminal line connection. . . . 2... 2 2 ee ew ew eee dial(3C) 
terminal number. tlytype: . 2... 6 1 6 ee ee ee ttytype(4) 
terminal or query terminfo . . . 2. 6 2 ee ee ee es tput(1) 
telmiinal SCTEGH. 66 6 ec Al Sa RE Se we: We et clear(1) 
terminal screen handling and .........++4.-. curses(3X) 
terminal session. . . 2. 6 2 0 6 ee se ee ee tw script(1) 
terminal settings used by . . 1... 2... ee eee gettydefs(4) 
terminal... 4 te ee SS RE we RA ee He EA Ge stty(1) 
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tabs: set tabs on a 

hpio: Hewlett-Packard 2645A 
and terminal/ tset: set 
system/ conlocate: locate a 
ty: get the name of the 
isatty: find name of a 

and line/ getty: set 

and line/ uugetty: set 
number. ttytype: list of 

vt: virtual 

functions of DASI 300 and 300s 
functions of Hewlett-Packard 
channels. tp: controlling 
term: conventional names for 
kill: 

Exit, exit: 

demon. errstop: 

for child process to stop or 
tic: 

initialize a terminal or query 
a termcap description into a 
infocmp: compare or print out 
data base. 

interface. 

fof common CTIX system 
message. 

command. 

isnan: isnand, isnanf: 

quiz: 

ed, red: 

ex: 

casual users). edit: 

change the format of a 

fspec: format specification in 
/checkeq: format mathematical 
prepare constant-width 

ms: 

nroff: format 

plock: lock process, 

more, page: 

strings: extract the ASCII 
off: typeset 

binary search trees. tsearch, 
structure. 

user interface to the DARPA 
DARPA TFTP protocol. 
Transfer Protocol server. 
tgetstr, tgoto, tputs:/ 

tputs:/ tgetent, tgetnum, 
protocol-speci fic service/ 
tgoto, tputs:/ tgetent, 

State. 

tgetent, tgetnum, tgetflag, 
Agemum, tgetflag, tgetstr, 


ttt, cubic: 
data and system/ timex: 
time: 


tenminal: <3. 4-4. 2 4s ae dhe ee oe ae ek ee SS @ Cash) 


terminal tape file archiver, . . . - - ee ee ee ees hpio(1) 
terminal, terminal interface, . ... . 2... ee ew eee tset(1) 
terminal to use asthe virtual . . . 2... 7 1 wee conlocate(1M) 
lenminal: dick 25.se) 6 eo Se SS Ye Se Se Ss tty(1) 
terminal. ttyname, ....... 2. ee ee eee ttyname(3C) 
terminal type, modes, speed, ... - 2-2 ee eee getty(1M) 
terminal type, modes, speed, ... - 2. - ee eee vugetty(1 M) 
terminal types by terminal . 2... 2 1 ee ee eee itytype(4) 
TERMINALS eS eR a ve eR, GS Ee Oe A Rs vt(7) 
terminals. fhandle special . . . 2. 2 2 1 ee ee eee 300(1) 
terminals. hp: handle special . 2... 1 2 ewe ee eee hp(i) 
terminal’ s local RS-232 2. 6 6 6 we ee ee ee ee tp(7) 
TONIMINGISS oak eS. i Se er tS ee Se a Sd term(S) 
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terminfo description. /convert . .. 2... we. captoinfo(1M) 
terminfo descriptions. . . . 2-6 6 ee ee ee infocmp(1M) 
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test your knowledge. 2... 2 0 0 ee tw eee te ee quiz(6) 
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text fornroffortroff.; 0206). wee ee eee aS eqn(1) 
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text, ordatain memory. .....- 6 2 es se we wee plock(2) 
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tfind, tdelete, walk: manage... 1... eee eee tsearch(3C) 
tfree: freealibrary . 2... 1 eee ee eh ee ene t_free(3n) 
TEYP protocol. Aho: is. é: cee See, ee, Be tftp(1) 
tfip: user interface tothe . 2... 6 1 ee ee ee ee 1fip(1) 
tftpd: DARPA Trivial File .. 2... 1... 2 ees tftpd(1M) 
tgetent, tgetnum, tgetflag, 2... ....-2.660- otermcap(3X) 
tgetflag, tgetstr,tgoto, . 2. + ee ew te ee otermcap(3X) 
t genio: Get seg oe ee es ee 8 t_getinfo(3n) 
tgetnum, tgetflag,tgetstr, .......+.4.046. otermcap(3X) 
t_getstate: getthe current. . .. 2... ee eee t_getstate(3) 
tgetstr, tgoto, tputs:// 6 6 ww ee wee ee otermcap(3X) 
tgoto, tputs: terminal/ . . . 2. 2 1 1 we ee otermcap(3X) 
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execute commands at a later 
a C shell environment at login 
systems for optimal access 


settimeofday: get/set date and 
profil: execution 

up an environment at login 
stime: set 

time: get 

of the/ adjtime: correct the 
tzset: convert date and 

clock: report CPU 

timezone: set default system 
process times. 

update access and modification 
get process and child process 
file access and modification 
process data and system/ 

time zone. 

cooperating STREAMS module. 


interface. 

read/wnite interface STREAMS/ 
request. 

event on a transport/ 

file. 

for a temporary file. 
fisascii, tolower, toupper, 
ftolower, _toupper, _tolower, 
graphical table of contents/ 
popen, pclose: initiate pipe 
houpper, tolower, _toupper, 
tolower, toupper, toascci, 
toascii:/ Conv: toupper, 
compare shared libraries 
endpoint. 

tsort: 

a transport endpoint. 
acctmerg: merge or add 
modification times of a file. 
ftoupper, toascci, _tolower, 
conv: toupper, tolower, 
local RS-232 channels. 


query terminfo database. 
Agetflag, tgetstr, tgoto, 


strace: print STREAMS 
ptrace: process 

error logging and event 

ftp: ARPANET file 

fipd: DARPA Intemet File 
tftpd: DARPA Trivial File 
/_toupper, _tolower, toascii: 
tr: 

tcp: Internet 

t_bind: bind an address to a 
t_close: close a 
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times of afile. touch: . . 2... 2 6 2 ee ee ee ws touch(1) 
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to/from aprocess. . 2... 2 6 ee se eee te we popen(3S) 
_tolower, toascii: translatef/ 6. 6. 6 we ee ee ee conv(3C) 
_tolower, _toupper,/ fisascll, .. .. + ++ ee eee ctype(3C) 
tolower, _toupper, tolower, . . - 2... 2 e+ 2 ees conv(3C) 
tool. chkshlib: 6. 6 eee wee Se we Bie chkshlib(1) 
t_open: establish atransport . . 1... 2s ee eee t_open(3n) 
topological sort. . 2 1 1 we eee eh eee ee ee tsort(1) 
t_optmgmt: manage options for... .. 1... t_optmgmt(3n) 
total accounting files. . . . . 1... 2 eee eee acctmerg(1M) 
touch: update accessand . . 2 2 6 ee ee ee eee touch(1) 
_toupper, setchrclass:// 2. 6 6 ee ee ee ee es ctype(3C) 
_toupper, _tolower, toascii:/ 2. 6 6 6 2 ee ee es conv(3C) 
tp: controlling terminal’s 2. 1 1 ee ee ee ee ee tp(7) 
tplot: graphics filters. . 2 2. 2 ee ee ee ee ee tplot(1G) 
tput: initialize aterminalor ...- +... ee ee eee tput(1) 
tputs: terminal independent/ ........... otermcap(3X) 
tr: translate characters. . . 2... + 2 ee ee ee ee tr(1) 
ACE TNESSAQES.. ee SK ae a Ow A strace(1M) 
CFCS. oe! sone Boke Gea ae ORS SG We Se ptrace(2) 
tracing. /jinterface toSTREAMS ..........24-2-. log(7) 
transfer program. . 2. 1. 6 6 6 ee ee eee ee we ftp(1) 
Transfer Protocol server, . 2. 6 ee ee ee eee ftpd(1M) 
Transfer Protocol server. . . 2... 6. 2 +e ee wee tftpd(1M) 
translate characters. . . 2... 6 ee ee we ew woe conv(3C) 
translate characters. . 2... 6 6 ee ee ee tw ew we es tr(1) 
Transmission Control Protocol. . . 2... 2 1 2 es ee ee tcp(7) 
transport endpoint. 2... 6 1 6 ee ee ee we t_bind(3n) 
transport endpoint. 2... 2 eee ee ee ee es t_close(3n) 
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look at the current event on a 
t_open: establish a 

/manage options for a 
t_unbind: disable a 
cooperating STREAMS/ timod: 
interface STREAMS tirdwr: 
t_sync: synchronize 

system. uucico: file 
nisprovider: get name of 

a connection with another 
expedited data sent over a/ 
confirmation from a connect/ 
from disconnect. 

of an orderly release/ 

unit. 

data error indication. 

ftw: walk a file 

twalk: manage binary search 
trk: 

tan, asin, acos, atan, atan2: 
server. tftpd: DARPA 


constant-width text for 
mathematical text for nroff or 
typesetting view graphs/ mv: a 
format tables for nroff or 


true, false: provide 

with debugging on. Uutry: 
twalk: manage binary search/ 
interface, and terminal/ 

tape drive. 

data over a connection. 
disconnect request. 

release. 


hbrary. 
contents routines. toc: dtoc, 


interface. 

terminal. 

a terminal. 

utmp file of the current/ 
types by terminal number. 
endpoint. 

/ranacct, shutacct, startup, 
tsearch, tfind, tdelete, 

file: determine file 

sysfs: get file system 

getty: set terminal 

uugetty: set terminal 
ttytype: list of terminal 
nodes for assorted device 
types. 

types: primitive system data 
session. script: make 
graphs, and slides. mmt, mvt: 


transport endpoim. t_look: . 2... 6. 1.6 ee eee t_look(3n) 
transport endpoint. . 2. 61 6 ee ee ee ee t_open(3n) 
transportendpoint. 2... 1. 6 ee ee es t_optmgmt(3n) 
transport endpoint. 2... 6 ee ee ee ee t_unbind(3n) 
Transport Interface . 2. 2 1 ee ee wee ee ee timod(7) 
Transport Interface read/write .. 2. 2... 2 ee eee tirdwr(7) 
transport library, 2-2. 6 eee ee we te et t_sync(3n) 
transport program forthe uucp .........4. nucico(1M) 
transport provider, . 6. 2 6 6 ee ee ee ee nlsprovider(3n) 
transport user. /establish  . 2... 2 1. we eee t_connect(3n) 
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t_rcvconnect: receive the .. 2... 2.2. ee ee t_rcvconnect(3) 
t_rcvdis: retrieve information ........-.6-. t_rcvdis(3n) 
t_rcvrel: acknowledge receipt... ... + 2. ees t_rcvrel(3n) 
t_rcvudata: receive aadata ... 1.2. 2.6 ee eee t_rcvudata(3) 
t_revuderr: receive aaunit ........46408. t_rcvuderr(3)} 
TOC rs eo Gs te oo SAS Ew: S. ee Se SE: G VOSS ftw(3C) 
trees. Afind,tdelete, . 2... 1. ee eee eee ee tsearch(3C) 
trekkic: Same. 6 abd eee Hes a el BW, se el ee trk(6) 
trigonometric functions. fcos, 2. 1 2 we we ee ee trig(3M) 
Trivial File Transfer Protocol ........4+.264.. tftpd(1M) 
trk: trekkié gamrse.: 6 ie ee Ke Re ew SS ee ) 
troff. cw, checkcw: prepare . 2 2. 2 2 ee ee ee tee cw(1) 
troff. fneqn, checkeq: format 2. 2 2 2 ww eee ee eqn(1) 
troff macro package for... 1 6 ee ee ew ee ew mv(5) 
(POM ABE os is a i ae A Oe a OE HE Aa ibl(1) 
troff: typeset text. 2. 0 2 0 wee tt tw we tte te troff(1) 
CRUE Walt s ey are as ae Gi cw Sak See fae we Sew Stee Ge we Se true(1) 
try tocontact aremote sysiem ......-2..2.. Uutry(iM) 
tsearch, tfind, tdelete, . 2... 2. 2 ew ee we ee tsearch(3C) 
tset: set terminal, terminal . . . 1... 1 6 1 ee ew ee tset(1) 
tsioctl: facilitate usage ofa . 2... 1 ee ee ee ws tsioctl(1) 
t_snd: send data orexpedited ........2..0+46- t_snd(3n) 
t_snddis: send user-initiated . 2... . 1 1 ee ee t_snddis(3n) 
t_sndrel: initiate anorderly ....... 2.2. ee. t_sndrel(3n) 
i_sndudata: send adata unit. . ......5 ee ee t_sndudata(3) 
tsort: topological sort. . 2... 1 1 ee ee ew ee ee tsort(1) 
t_sync: synchromize transport. . 2... 1 2 ee ee t_sync(3n) 
ttoc, vtoc: graphical table of . 2... 2... 2 ee eee toc(1G) 
{tt Cubic: TiG-laC4Oe.. a5 <é: 6 xs ce: A hr a es SE ew ttr(6) 
tty: controlling terminal... 2... 1.1. 1 eee eee tty(7) 
tty: getthe name ofthe . . 1. 1 ew ee ee ee tty(1) 
ttyname, isatty: findnameof ........2... ttyname(3C) 
ttyslot: find the slotinthe .........4.e+8. ttyslot(3C) 
ttytype: list ofterminal . 2. 2 2 2 1 wee ee ee ttytype(4) 
t_unbind: disable atransport . . 1... 1. we eee t_unbind(3n) 
tumacct: shell procedures forf/ 2... 1. 1 ew ee acctsh(1M) 
twalk: manage binary search/ .......-+.4.-. tsearch(3C) 
1YPEs bods Siar cd, Mee be a Ee we Es file(1) 
type information. . 2... 6 6 ee we ee we eee sysfs(2) 
type, modes, speed, andline/ . 2 ww we ee ee es getty(1M) 
type, modes, speed, and line/ . . ..- 2... 22s. uugetty(1M) 
types by terminal number. . . .. 1... 2 ee eee ttytype(4) 
types. /create device . 2. 2 2 2 2 ew ee ew createdev(IM) 
types: primitive system data .........804-. types(5) 
FYOER | <5 ce: Sub Wiel as a Se + ee Re ee oS types(5) 
typescript ofterminal . . 2. 1 1 ee ee ee eh es scnipt(1) 
typeset documents, view . . 2... 6 0 ee eee eee mmt(1) 
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troff: 

mv: a troff macro package for 
to/ /asctime, cftime, ascftime, 
control. 

control. 

system. 

Protocol. 

getpw: get name from 


/endspent, fgetspent, Ickpwdf, 
limits. 

creation mask. 

mask. 

systems and remote/ mount, 


multipie file/ mountall, 
File Sharing resource. 
Sharing resource. unadv: 
CTIX system. 

CTIX system. 

ul: do 

file. unget: 

spaces, and vice/ expand, 
an SCCS file. 

into input stream. 

/seed48, lcong48: generate 
a file. 

mktemp: make a 
gethostid, sethostid: get/set 
symbolic constants. 
t_rcvuderr: receive 2 
t_rcvudata: receive a data 
t_sndudata: send a data 


mc68k, miti, mini, mega, 
execution. uux: 

uucp, uulog, uuname: 

uuto, uupick: public 

link, unlink: link and 

entry. 

umount: 

mount, umount: mount and 
mountall, umountall: mount, 
nmountall, numountall: mount, 
resource. fumount: forced 
rmountal], ramountall: mount, 
manage notifications. notify, 
files. pack, pcat, 

times of a file. touch: 

of programs. make: maintain, 
pwconvy: install and 
pwunconv: install and 

Ifind: linear search and 
synchronization. 

sync: 

masterupd: 

sync: 

du: summarize disk 


typeset text. 6 ww we he troff(1) 


typesetting view graphs and/ .......-.. =... . mv(5) 
izset: convert dateandtime .......-...4.-. ctime(3C) 
uadmin: administrative . 2... 6 ee ee ee ee uadmin(i M) 
uadmin: administrative ... 2... 1.56 6 ee eee uadmin(2) 
uconf: configure the operating ....-.-+-++e. uconf(iM) 
udp: Internet User Datagram... 1. 2 1 6 2 ee ees udp(7) 
VID: . oo ae tes hh, BP en i le Sie ie! Tee ee ee ee Se et getpw(3C) 
ul: do underlining. . 2. 6 2 6 6 6 eee ee ee et ul(1) 
ulckpwdf: get shadow. . © 2 2 2 2 ee ee eee getspent(3X) 
ulimit: get and setuser «2 2 ww ee ee ee ee ulimit(2) 
umask: set and get file 2... 6 1 ee eee wee umask(2) 
umask: set file-creation mode ..... ++ + +s e-e umask(1) 
umount: mount and unmount fille .......... mount(1M) 
umount: unmount a file system. .........2.-. umount(2) 
umountall: mount, unmount .....- +. 2... mountall(1M) 


unadv: unadvertise aRemote ...... + +6 «eas unadv(1M) 
unadvertise a Remote File .......-- 2 we eee unadv(1M) 
uname: get name of current . 2... 6. eee ee eee uname(2) 
uname: print name of current . . 2. 2 7 ee ee ee uname(1) 
inderliming: “i044 @ 6 wee ea a ee ul(1) 
undo a previous get of anSCCS . 2... 6 1 2 ee ae unget(1) 
unexpand: expand tabs to . . 2. 6 1 ee ee we ee expand(1) 
unget: undo a previous getof . 2. 6 6 6 ee ee ee unget(}) 
ungetc: push character back . . 2... 2+ 2 sees ungetc(3S) 


uniformly distributed/ . . 2... 6. 6 1 ee eh ee drand48(3C) 
unig: report repeated linesin . . 2. 7 ee ee eee uniq(1) 
unique file name. . . . 2. 2 6 ee ee et te es mktemp(3C) 
unique identifier of curren/ . . 2... 1. +e 2 eee gethostid(2) 
unistd: file headerfor . . . . 2 1. 2 2. 2 © 2 2 we eee unistd(4) 
unit data errorindication. ......+ +52... t_rcvuderr(3) 


RUGS ae: ale ho a tas ces a Ds t_rcvudata(3) 
MUGS ck Sie Moy sale Ee a a es ea ae Ee ah t_sndudata(3) 
units: conversion program. . . . 2. 2 6 ee ee ee units(1) 
unixpc,. machid: . 2... 6 1 2 ew ee ee ee machid(1) 
UNIX-to-UNIX system command .........-.. uux(1C) 
UNIX-to-UNIX system copy. .....-6 2-20. uucp(IC) 


UNIX-to-UNIX system file copy. . 2... -...-6. uuto(iC) 


unlink files and directories. . .. 1... 6 ee ee ee link(1M) 
unlink: remove directory .. 2... 6 6 ee we ee unhink(2) 
unmount a file system. . . 2... 2 6 ee ee ew ee umount(2) 


unmount file systems andf . . 2. 2. 2 2 6 ee we mount(1M) 
unmount multiple file systems. . .....--+..- mountall(1M) 
unmount Network File System/  .........- nmountall(1M) 
unmount of an advertised .......-2.+.+246-4 fumount(1M) 
unmount Remote File Sharing/ . . . 2... 1. tmountall(1M) 
unnotify, evwait,evnowalt: .... 2... 2... e., notify (2) 


unpack: compress andexpand .. 2... 1 eee eee pack(1) 
update access and modification ......- 2. ees touch(1) 
update, and regenerate groups . .... + +e ee eee make(1) 


update /etc/shadow with/ . . 2... 6 2 ee ew eee pwconv(1M) 
update /etc/shadow with/ . . . . 2... ee eee pwunconv(iM) 


update. Isearch, . 2. - 2 2 2 ee ee we ew ww Isearch(3C) 
update: provide disk .. 2... 2-2. 5 eee eee update(1M) 
update super block. . . 2... 2. 1 2 eee ee eee sync(2) 
update the master file. 2. 2... 2 1 eee eee masterupd(i M) 
update the super block. . 2... 1... 1 ee ee eee sync(iM) 
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a command descnption and 
tsioct]: facilitate 

description and usage/ 

stat: statistical network 

id: print 

setuid, setgid: set 

idload: Remote File Shanng 
talkd: remote 

crontab: 

character login name of the 
udp: Internet 

/getgid, getegid: get real 
environ: 

disk accounting data by 
program. finger: 

fingerd: remote 

protocol. telnet: 

TFTP protocol. tftp: 

ulimit: get and set 

logname: retum login name of 
/get real user, effective 
become super-user or another 
iaik: taik to another 

with another transport 

the utmp file of the current 
wnte: write to another 
request. t_snddis: send 
(vanant of ex for casual 

mail, rmail: send mail to 
thosts: remote equivalent 
operating system for beginning 
wall: write to all 

fuser: identify processes 
search a file for a pattern 
identify a CTIX system command 
assist: assistance 

Anstall and verify software 
failed login attempts. 
statistics. 

gutil: graphical 

modification times. 

uimp, wimp: 

endutent, utmpname: access 
ttyslot: find the slot in the 
/pututline, setutent, endutent, 
directories and permissions/ 
for the uucp system. 
directory clean-up. 
/configuration file for 
uucheck: check the 

uucpd, ouucpd: network 
uucleanup: 

control. uustat: 

file transport program for the 
uusched: the scheduler for the 
UNIX-to-UNIX system copy. 
servers. 

modes, speed, and line/ 


usage examples. /retneve . . 2... 1 1 ee ee ee usage(1) 
usage ofatape drive. . 2... 6. 1 ee ee ee tsioct](1) 
uSage: retrieve acommand .........-..4048-6 usage(1) 
useful with graphical/ 2... 1 2 ee ee ee ees stat(1G) 
user and group [Ds andmames. ....-....-+ 22. id(iM) 
userand groupIDs. .«.. 6 6 6 6 8 ee ee ee we setuid(2) 
user and group mapping. .... 2... +e. 2 eee idload(1M) 
user Communication server. . . 2... 2 1 ee ee ee talkd(1M) 
user crontab fille. 2... 2... 0 ee ee ew we we ts crontab(1) 
OSet, CUSETId:.@CE 5. kk es Bo we SE we ws Oe cusenid(3S) 
User Datagram Protocolh . 2... 2 2 2 ee ee ee ee udp(7) 
user, effective user,real/ . . 1. 1 1 we we ee te getuid(2) 
user environment. . . 6. 6 6 6 ee ew et et te environ(S) 
user ID. diskusg: generate .......2.4-+.46- diskusg(1M) 
user information lookup... ... 1... s+ eee ae finger(1) 
user information server... 6... 6 ee ee ees fingerd(iM) 
user interface to TELNET .........6+48084- telnet(1) 
user interface tothe DARPA .........2..02e8-. tftp(1) 
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USED oe ee a iw ar St Ge Hw eee ae ce logname(3X) 
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MISO: SUE 2c 4 ah wes ae wea a su(tM) 
MSGR 5-8 whe ie BE lee ee he i a as Fe ae we talk(1) 
user. /establish aconnection . .... 2. + we eee t_connect(3n) 
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NAME 
intro - introduction to system calls and error numbers 


SYNOPSIS 
#include <errno.h> 


DESCRIPTION 
This section describes the system calls, most of which have one or more error 
returns. An error condition is indicated by an otherwise impossible returned 
value. This is almost always -1 or the NULL pointer; the individual descriptions 
specify the details. An error number is also made available in the external 
variable errno. Errno is not cleared on successful calls, so it should be tested 
only after an error has been indicated. 


Each system call description attempts to list all possible error numbers. The 


following is a complete list of the error numbers and their namcs as defined in 


<errno.h>. 
1 EPERM Not owner or super-user 


Typically this error indicates an attempt to modify a file in some way 
forbidden except to its owner or super-user. It is also returned for 
attempts by ordinary users to do things allowed only to the super- user. 


Z ENOENT No such file or directory 


This error occurs when a file name is specified and the file should exist 
but doesn’t, or when one of the directories in a path name does not 


exist. 

3 ESRCH No such process 
No process can be found corresponding to that specified by pid in 
kill(2) or ptrace(2). 

4 EINTR Interrupted system call 


An asynchronous signal (such as interrupt or quit), which the user has 
elected to catch, occurred during a system call. If execution is 
resumed after processing the signal, it will appear as if the interrupted 
system call returned this error condition. 


5 EIO 1/O error 


Some physical YO error has occurred. This error may in some cases 
occur on a call following the one to which it actually applies. 
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ENXIO No such device or address 


I/O on a special file refers to a subdevice which does not exist, or 
beyond the limits of the device. It may also occur when, for example, 
a tape drive is not on-line or no disk pack is loaded on a drive. 


E2BIG Arg list too long 


An argument list longer than 5,120 bytes is presented to a member of 
the exec (2) family. 


ENOEXEC Exec format error 


A request is made to execute a file which, although it has the 
appropriate permissions, does not start with a valid magic number [see 
a.out(4)}. 


EBADF Bad file number 


Either a file descriptor refers to no open file, or a read(2) [write (2)] 
request is made to a file which is open only for writing (respectively, 
reading). 


ECHILD No child processes 


A wait was executed by a process that had no existing or unwaited- for 
child processes. 


EAGAIN No more processes 


A fork failed because the system’s process table is full or the user is not 
allowed to create any more processes, a system call failed because of 
insufficient memory or swap space, or an IPC call is made with the 
IPC_NOWAIT and the caller would block. 


ENOMEM Not enough space 


During an exec(2), brk(2), or sbrk(2), a program asks for more space 
than the system is able to supply. This may not be a temporary 
condition; the maximum space size is a system parameter. The error 
may also occur if the arrangement of text, data, and stack segments 
requires too many segmentation registers, or if there is not enough 
swap space during a fork(2). If this error occurs on a resource 
associated with Remote File Sharing (RFS), it indicates a memory 
depletion which may be temporary, dependent on system activity at 
the time the call was invoked. 
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EACCES Permission denied 


An attempt was made to access a file or an IPC structure in a way 
forbidden by the protection system. 


EFAULT Bad address 


The system encountered a hardware fault in attempting to use an 
argument of a system call. 


ENOTBLK Block device required 


A non- block file was mentioned where a block device was required: 
for example, in mount(2). 


EBUSY Device or resource busy 


An attempt was made to mount a device that was already mounted or 
an attempt was made to dismount a device on which there is an active 
file (open file, current directory, mounted-on file, active text segment). 
It will also occur if an attempt is made to enable accounting when it is 
already enabled. The device or resource is currently unavailable. 


EEXIST File exists 


An existing file was mentioned in an inappropriate context: for 
example, link(2). 


EXDEV Cross-device link 
A link to a file on another device was attempted. 
ENODEV No such device 


An attempt was made to apply an inappropriate system call to a 
device: for example, read a write-only device. 


ENOTDIR Not a directory 


A non-directory was specified where a directory is required, for 
example in a path prefix or as an argument to chdir (2). 


EISDIR Is a directory 


An attempt was made to write on a directory. 
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EINVAL Invalid argument 


Some invalid argument [for example, dismounting a non-mounted 
device; mentioning an undefined signal in signal(2) or kill(2); reading 
or writing a file for which /seek(2) has generated a negative pointer]. 
Also set by the math functions described in the (3M) entries of this 
manual. 


ENFILE File table overflow 


The system file table is full, and temporarily no more opens can be 
accepted. 
EMFILE Too many open files 


No process may have more than NOFILES (default 20) descriptors open 
at a time. When a record lock is being created with fcnil, there are too 
many files with record locks on them. 


ENOTTY Not a character device (or) Not a typewriter 


An attempt was made to iocti(2) a file that is not a special character 
device. 


ETXTBSY Text file busy 


An attempt was made to execute a pure-procedure program that is 
currently open for writing. Also an attempt to open for writing or to 
remove a pure- procedure program that is being executed. 


EFBIG File too large 


The size of a file exceeded the maximum file size or ULIMIT {see 


2 fANT 


ulimit (2)}. 
ENOSPC No space left on device 


During a write(2) to an ordinary file, there is no free space left on the 
device. In an IPC call, no IPC identifiers are available. 


ESPIPE Illegal seek 
An lseek(2) was issued to a pipe. 
EROFS Read-only file system 


An attempt to modify a file or directory was made on a device 
mounted read-only. 
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EMLINK Too many links 


An attempt to make more than the maximum number of links (1000) to 
a file. 


EPIPE Broken pipe 


A write on a pipe for which there is no process to read the data. This 
condition normally generates a signal; the error is returned tf the signal 
is ignored. 

EDOM Math argument 


The argument of a function in the math package (3M) is out of the 
domain of the function. 


ERANGE Result too large 


The value of a function in the math package (3M) 1s not representable 
within machine precision. 


ENOMSG No message of desired type 


An attempt was made to receive a message of a type that does not exist 
on the specified message queue [see msgop(2)]. 


EIDRM Identifier removed 


This error is returned to processes that resume execution due to the 
removal of an identifier from the file system’s name space [see 
msgctl(2), semctl(2), and shmctl (2)]. 


ECHRNG Channel number out of range 
Not used; retained for compatibility. 
EL2ZNSYNC Level 2 not synchronized 
Not used; retained for compatibility. 
EL3HALT Level 3 halted 

Not used; retained for compatibility. 
EL3RST Level 3 reset 

Not used; retained for compatibility. 
ELNRNG Link number out of range 


Not used; retained for compatibility. 
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EVNATCH Protocol driver not attached 
Not used; retained for compatibility. 
ENOCSI No CSI structure available 
Not used; retained for compatibility. 
EL2HLT Level 2 halted 

Not used; retained for compatibility. 
EDEADLK Deadlock 


A deadlock situation was detected and avoided. This error pertains to 
file and record locking provided by fcntl (2). 


ENOLCK No lock 


In fenti(2), the setting or removing of record locks on a file cannot be 
accomplished because there are no more record entries left on the 
system. 


EBADE Invalid exchange 


A user-specified exchange descriptor is out of range or specifies an 
unallocated exchange. ( 


EBADR Invalid request descriptor 


An attempt has been made to reference a request that is not 
outstanding. 


EXFULL Exchange full 


No request descriptors are currently available for this exchange. 
ENOANO No anode 

Not used; retained for compatibility. 

EBADRQC Invalid request code 

No routing is currently available for this request code. 
EBADSLT Invalid slot 


The slot number specified for an ICC request is not present in the 
system. (No longer used; retained for compatibility.) 
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EDEADLOCK Deadlock error 


Call cannot be honored because of potential deadlock or because lock 
table is full. [Note that this return value is associated with locking (2) 
and differs from the EDEADLK of fcnil(2); see the WARNING on 
locking (2).] 


EBFONT Bad font file format 
Not used; retained for compatibility. 
ENOSTR Nota stream 


A putmse(2) or getmse(2) system call was attempted on a file 
descriptor that is not a STREAMS device. 

ETIME Stream ioctl timeout 

The timer set for a STREAMS iocil(2) call has expired. The cause of 
this error is device specific and could indicate either a hardware or 
software failure, or perhaps a timeout value that is too short for the 


specific operation. The status of the ioctl(2) operation is 
indeterminate. 


ENOSR No stream resources 


During a STREAMS open(2), either no STREAMS queues or no 
STREAMS head data structures were available. 


ENONET Machine is not on the network 


This error is Remote File Sharing (RFS) specific. It occurs when users 
try to advertise, unadvertise, mount, or unmount remote resources 
while the machine has not done the proper startup to connect to the 
network. 


ENOPKG No package 


This error occurs when users attempt to use a system call from a 
package which has not been installed. 


EREMOTE Resource is remote 


This error is RFS specific. It occurs when users try to advertise a 
resource which is not on the local machine, or try to mount/unmount a 
device (or pathname) that is on a remote machine. 


ENOLINK Virtual circuit is gone 


This error is RFS specific. It occurs when the link (virtual circuit) 
connecting to a remote machine is gone. 


se 
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EADV Advertise error 


This error is RFS specific. It occurs when users try to advertise a 
resource which has been advertised already, or try to stop the RFS 
while there are resources still advertised, or try to force unmount a 
resource when it is still advertised. 


ESRMNT Srmount error 


This error is RFS specific. It occurs when users try to stop RFS while 
there are resources still mounted by remote machines. 


ECOMM Communication error 


This error is RFS specific. It occurs when trying to send messages to 
remote machines but no virtual circuit can be found. 


EPROTO Protocol error 


Some protocol error occurred. This error is device specific, but is 
generally not related to a hardware failure. 


EMULTIHOP Multihop attempted 


This error is RFS specific. It occurs when users try to access remote 
resources which are not directly accessible. 


EBADMSG Bad message 


During a read(2), getmsg(2), or ioctl(2) ILRECVFD system call to a 
STREAMS device, something has come to the head of the queue that 
can’t be processed. That something depends on the system call: 


read(2) Control information or a passed file descriptor. 
getmsg(2) Passed file descriptor. 

ioctl(2) Control or data information. 

ELIBACC Cannot access a needed shared library 


Trying to exec(2) an a.out that requires a shared library (to be linked 
in) and the shared library doesn’t exist or the user doesn’t have 
permission to use it. 


ELIBBAD Accessing a corrupted shared library 


Trying to exec(2) an a.out that requires a shared library (to be linked 
in) and exec(2) could not load the shared library. The shared library is 
probably corrupted. 
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ELIBSCN .lib section in a.out corrupted 


Trying to exec(2) an a.out that requires a shared library (to be linked 
in) and there was erroneous data in the .lib section of the a.out. The .lib 
section tells exec(2) what shared libraries are needed. The a.out is 
probably corrupted. 


ELIBMAX Attempting to link in more shared libraries than 
system limit 


Trying to exec(2) an a.out that requires more shared libraries (to be 
linked in) than is allowed on the current configuration of the system. 
See the §/Series CTIXAdministrator’ sGuide. 

ELIBEXEC Cannot exec a shared library directly 

Trying to exec(2) a shared library directly, This ts not allowed. 


ENOHDW No hardware available for operation 


The address specification exceeds the allowable limits or the required 
hardware does not exist (for example, the executable file requires 
hardware that is not available). See exec (2). 


EBADFS Bit-mapped file system is marked dirty 


An attempt to mount a bit-mapped file system failed due to the dirty 
flag being set for that file system. 


EWOULDBLOCK Operation would block 


An operation which would cause a process to block was attempted on 
an object in non-blocking mode. 

EINPROGRESS Operation now in progress 

An operation which takes a long time to complete [such as a 
connect(2)] was attempted on a non-blocking object. 

EALREADY Operation already in progress 


An operation was attempted on a non-blocking object which already 
had an operation in progress. 


ENOTSOCK Socket operation on non-socket 


Self-explanatory. 
EDESTADDRREQ Destination address required 


A required address was omitted from an operation on a socket. 


INTRO(2) 


231 


232 


233 


234 


235 


236 


237 


238 


239 


240 


241 


INTRO(2) 


EMSGSIZE Message too long 


A message sent on a socket was larger than the internal message 
buffer. 


EPROTOTYPE Protocol wrong type for socket 


A protocol was specified which does not support the semantics of the 
socket type requested. For example, you cannot use the ARPA Internet 
UDP protocol with type SOCK_STREAM. 


EPROTONOSUPPORT Protocol not supported 


The protocol has not been configured into the system or no 
implementation for it exists. 


ESOCKTNOSUPPORT Socket type not supported 


The support for the socket type has not been configured into the 
system or no implementation for it exists. 


EOPNOTSUPP Operation not supported on socket 
For example, trying to accept a connection on a datagram socket. 
EPFNOSUPPORT Protocol family not supported 


The protocol family has not been configured into the system or no 
implementation for it exists. 


~EAFNOSUPPORT Address family not supported by protocol 


An address incompatible with the requested protocol was used. For 
example, you shouldn’t necessarily expect to be able to use PUP 
Internet addresses with ARPA Internet protocols. 


EADDRINUSE Address already in use 
Only one usage of each address is normally permitted. 
EADDRNOTAVAIL Can’t assign requested address 


Normally results from an attempt to create a socket with an address not 
on this machine. 


ENETDOWN Network is down 


A socket operation encountered a dead network. 
ENETUNREACH Network is unreachable 


A socket operation was attempted to an unreachable network. 
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ENETRESET Network dropped connection on reset 

The host you were connected to crashed and rebooted. 
ECONNABORTED Software caused connection abort 

A connection abort was caused internal to your host machine. 
ECONNRESET Connection reset by peer 


A connection was forcibly closed by a peer. This normally results 
from the peer executing a shutdown (2) call. 


ENOBUFS No buffer space available 


An operation on a socket or pipe was not performed because the 
system lacked sufficient buffer space. 
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A connect request was made on an already connected socket; or, a 
sendto or sendmsg request on a connected socket specified a 
destination other than the connected party. 


ENOTCONN Socket is not connected 


An request to send or receive data was disallowed because the socket 
is not connected. 


ESHUTDOWN Can’t send after socket shutdown 


A request to send data was disallowed because the socket had already 
been shut down with a previous shutdown (2) call. 


ETOOMANYREFS Too many references: can’t splice 
Not in use; included for compatibility only. 
ETIMEDOUT Connection timed out 


A connect request failed because the connected party did not properly 
respond after a period of time. (The timeout period is dependent on 
the communication protocol.) 


ECONNREFUSED Connection refused 


No connection could be made because the target machine actively 
refused it. This usually results from trying to connect to a service 
which is inactive on the foreign host. 


EHOSTDOWN Host is down 


The host is down. 
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253 EHOSTUNREACH No route to host 


The gateway does not recognize the requested host via the route 
specified. 


254 ENOPROTOOPT Protocol not available 
A bad option was specified in a getsockopt (2) or setsockopt (2) call. 


DEFINITIONS 
Process ID Each active process in the system is uniquely identified by a 
positive integer called a process ID. The range of this ID is from 1 to 30,000. 


Parent Process ID A new process is created by a currently active process [see 
fork(2)]. The parent process ID of a process is the process ID of its creator. 
Process Group ID Each active process is a member of a process group that is 
idcniificd bY a positive inicger Calied ihe process group iD. This ID 1s ihe 
process ID of the group leader. This grouping permits the signaling of related 
processes [see kill(2)]. 


Tty Group ID Each active process can be a member of a terminal group that is 
identified by a positive integer called the tty group ID. This grouping is used to 
terminate a group of related processes upon termination of one of the processes 
in the group [See exit(2) and signal (2)]. 


Real User ID and Real Group ID Each user allowed on the system is identified 
by a positive integer (0 to 65535) called a real user ID. 


Each user is also a member of a group. The group ts identified by a positive 
integer called the real group ID. 


An active process has a real user ID and real group ID that are set to the real 
user ID and real group ID, respectively, of the user responsible for the creation 
of the process. 


Effective User ID and Effective Group ID An active process has an effective 
user ID and an effective group ID that are used to determine file access 
permissions (see below). The effective user ID and effective group ID are equal 
to the process’s real user ID and real group ID, respectively, unless the process 
or one of its ancestors evolved from a file that had the set-user-ID bit or set- 
group- ID bit set [see exec(2)]. 


Super-user A process is recognized as a super-user process and is granted 
special privileges, such as immunity from file permissions, if its effective user 
ID is 0. 
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Special Processes The processes with a process ID of O and a process ID of 1 
are special processes and are referred to as procO and proc!. 


ProcO is the scheduler. Proc! is the initialization process (init). Procl is the 
ancestor of every other process in the system and is used to control the process 
structure. 


File Descriptor A file descriptor is a small integer used to do I/O on a file. The 
value of a file descriptor is from 0 to (NOFILES - 1). A process may have no 
more than NOFILES file descriptors open simultaneously. A file descriptor is 
returned by system calls such as open(2), or pipe(2). The file descriptor is used 
as an argument by calls such as read(2), write(2), ioctl(2), and close(2). 


File Name Names consisting of 1 to 14 characters may be used to name an 
ordinary file, special file or directory. 


These characters may be seiected from the set of ali character vaiues excluding 
\O (null) and the ASCII code for / (slash). 


Note that it is generally unwise to use *, ?, [, or ] as part of file names because 
of the special meaning attached to these characters by the shell [see sh(1)]. 
Although permitted, the use of unprintable characters in file names should be 
avoided. 


Path Name and Path Prefix A path name is a null-terminated character string 
Starting with an optional slash (/), followed by zero or more directory names 
separated by slashes, optionally followed by a file name. 


If a path name begins with a slash, the path search begins at the root directory. 
Otherwise, the search begins from the current working directory. 


A slash by itself names the root directory. 


Uniess specifically stated otherwise, the null path name is treated as 1f 1t named 
a non-existent file. 

Directory Directory entries are called links. By convention, a directory 
contains at least two links, . and .., referred to as dot and dot- dot , respectively. 
Dot refers to the directory itself and dot- dot refers to its parent directory. 


Root Directory and Current Working Directory Each process has associated 
with it a concept of a root directory and a current working directory for the 
purpose of resolving path name searches. The root directory of a process need 
not be the root directory of the root file system. 
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File Access Permissions Read, write, and execute/search permissions on a file 
are granted to a process if one or more of the following are true: 


e The effective user ID of the process is super-user. 


e The effective user ID of the process matches the user ID of the owner of 
the file and the appropriate access bit of the ‘‘owner’’ portion (0700) of 
the file mode is set. 


e The effective user ID of the process does not match the user ID of the 
owner of the file, and the effective group ID of the process matches the 
group of the file and the appropriate access bit of the ‘‘group’’ portion 
(0070) of the file mode is set. 


e The effective user ID of the process does not match the user ID of the 
owner of the file, and the effective group ID of the process does not 
maich ihe group iD of ihe file, and the appropriate access 
bit of the ‘‘other’’ portion (0007) of the file mode is set. 

Otherwise, the corresponding permissions are denied. 


Message Queue Identifier A message queue identifier (msqid) is a unique 
positive integer created by a msgget(2) system call. Each msqid has a message 
queue and a data structure associated with it. The data structure is referred to as 
msqid_ds and contains the following members: 


struct ipc perm msg _ perm; 
struct msg *msg first; 
struct msg *msg last; 
ushort msg_cbytes; 
ushort msg_gqnum; 
ushort msg_qbytes; 
ushort msg _Ispid; 
ushort msg Irpid; 
time t msg stime; 
time _t msg _rtime; 
time t msg _ctime; 


msg _ perm Is an ipc_perm structure that specifies the message 
operation permission (see below). This structure 
includes the following members: 


ushort cuid; /* creator user id +/ 
ushort cgid; /* creator group id «/ 
ushort uid; /* user id */ 

ushort gid; /* group id */ 
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ushort mode; /* r/w permission «/ 
ushort seq; /* slot usage sequence # «/ 
key t key; /* key */ 
msg *msg first Is a pointer to the first message on the queue. 
msg *msg last Is a pointer to the last message on the queue. 
msg_cbytes Is the current number of bytes on the queue. 
msg _qnum Is the number of messages currently on the queue. 


msg _ qbytes Is the maximum number of bytes allowed on the 
queue. 


msg _Ispid Is the process ID of the last process that performed a 
msgsnd operation. 


msg Irpid Is the process ID of the last process that performed a 
msgrcy operation. 


msg_stime Is the time of the last msgsnd operation. 
msg _rtime Is the time of the last msgrcv operation. 
msg ctime Is the time of the last msgctl(2) operation that 


changed a member of the above structure. 


Message Operation Permissions In the msgop(2) and msgcil(2) system call 
descriptions, the permission required for an operation is given as "{token}", 
where "token" is the type of permission needed, interpreted as follows: 


00400 Read by user 
00200 Write by user 
00040 ~=— Read by group 
00020 Write by group 
00004 = Read by others 
00002 Write by others 


Read and write permissions on a msqid are granted to a process if one or more 
of the following are true: 


e The effective user ID of the process is super- user. 


e The effective user ID of the process matches msg perm.cuid or 
msg perm.uid in the data structure associated with msqid and the 
appropriate bit of the ‘‘user’’ portion (0600) of msg_perm.mode is set. 
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e The effective group ID of the process matches msg perm.cgid or 
msg perm.gid and the appropriate bit of the “‘group’’ portion (060) of 
msg _perm.mode is set. 


e¢ The appropriate bit of the ‘‘other’’ portion (006) of msg_perm.mode is 
SeL 


Otherwise, the corresponding permissions are denied. 


Semaphore Identifier A semaphore identifier (semid) is a unique positive 
integer created by a semget(2) system call. Each semid has a set of semaphores 
and a data structure associated with it. The data structure is referred to as 
semid_ds and contains the following members: 


struct ipc_permsem_perm;  /* operation permission+/ 


/* struct +/ 
struct sem *sem_base; /* ptr to first semaphore in set +/ 
ushort sem_nsems; /* number of sems in set +/ 
time_t sem_otime; /* last operation time */ 
time_t sem_ctime; /+ last change time +/ 


/* Times measured in secs since «/ 
/* 00:00:00 GMT, Jan. 1, 1970 «/ 


sem_perm Is an ipc_perm structure that specifies the 
semaphore operation permission (see below). This 
structure includes the following members: 


ushort uid; /* user id */ 
ushort gid; /* group id */ 
ushort  cuid; /* creator user id +/ 


ushort cgid; /* creator group id */ 

ushori mode;  /* ria permission */ 

ushort seq; /+ slot usage sequence number */ 
key t= key; Is key +/ 


sem_nsems Is equal to the number of semaphores in the set. Each 
semaphore in the set is referenced by a positive 
integer referred to as a sem_num. Sem_num values 
run sequentially from 0 to the value of sem_nsems 


minus 1. 
sem_otime Is the time of the last semop(2) operation. 
sem_ctime Is the time of the last semctl(2) operation that 


changed a member of the above structure. 
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A semaphore is a data 
members: 


ushort semval; 
short sempid; 
ushort semncnt; 
ushort semzcnt; 


semval 


sempid 


semncnt 
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structure called sem that contains the following 


/* semaphore value +/ 

/* pid of last operation +/ 

/+ # awaiting semval > cval +/ 
/x $ awaiting semval = 0 +/ 


Is a non-negative integer which is the actual value of 
the semphore. 


Is equal to the process ID of the last process that 
performed a semaphore operation on this semaphore. 


Is a count of the number of processes that are 
currently suspended awaiting this semaphore’s 
semval to become greater than its current value. 

Is a count of the number of processes that are 


currently suspended awaiting this semaphore’s 
semval to become zero. 


Semaphore Operation Permissions In the semop(2) and semctl(2) system call 
descriptions, the permission required for an operation is given as "{token}", 
where "token" is the type of permission needed interpreted as follows: 


00400 ~=Read by user 
00200 = Alter by user 
00040  ~=Read by group 
00020 = Alter by group 
00004 = Read by others 
00002 Alter by others 


Read and alter permissions on a semid are granted to a process if one or more of 


the following are true: 


e The effective user ID of the process is super- user. 


e The effective user ID of the process matches sem_perm.cuid or 
sem perm.uid in the data structure associated with semid and the 
appropriate bit of the ‘‘user’’ portion (0600) of sem_perm.mode is set. 


e The effective group ID of the process matches sem_perm.cgid or 
sem_perm.gid and the appropriate bit of the ‘‘group’’ portion (060) of 
sem _perm.mode is set. 


e The appropriate bit of the ‘‘other’’ portion (006) of sem_perm.mode is 


set. 
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Otherwise, the corresponding permissions are denied. 


Shared-Memory Identifier A shared-memory identifier (shmid) is a unique 
positive integer created by a shmget(2) system call. Each shmid has a segment 
of memory (referred to as a shared memory segment) and a data structure 
associated with it. (Note that these shared memory segments must be explicitly 
removed by the user after the last reference to them is removed.) The data 
structure is referred to as shmid_ds and contains the following members: 


struct ipc_perm shm_perm; /* operation permission +/ 
struct */ 

int shm_segsz; /+ size of segment +/ 

ushort shm_Ipid; /+ pid of last operation */ 

ushort shm_cpid; /* creator pid */ 

ushort shm_nattch; /* number of current attaches «/ 

time_t shm_atime; /+ last attach time +/ 

time_t shm_dtime; /* last detach time +/ 

time t shm_ctime; /* last change time */ 


/« Times measured in secs since */ 
{x 00:00:00 GMT, Jan. 1, 1970 */ 


shm_perm Is an ipc_perm structure that specifies the shared 
memory operation permission (see below). This 
structure includes the following members: 


ushort cuid; /* creator user id */ 
ushort cgid; /* creator group id +/ 


ushort = _uld; /* user id +/ 
ushort gid; /* group id */ 
ushort mode; _ /* r/w permission «/ 
ushort seq; /* slot usage sequence number +/ 
key_t key; /* key */ 
shm_segsz Specifies the size of the shared memory segment in 
bytes. 
shm_cpid Is the process ID of the process that created the 
shared memory identifier. 
shm_Ipid Is the process ID of the last process that performed a 
shmop (2) operation. 
shm_nattch Is the number of processes that currently have this 
segment attached. 
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shm_atime Is the time of the last shmat(2) operation. 
shm_dtime Is the time of the last shmdt(2) operation. 


shm_ctime Is the time of the last shmctl(2) operation that 
changed one of the members of the above structure. 


Shared-Memory Operation Permissions In the shmop(2) and shmctl(2) 
system call descriptions, the permission required for an operation is given as 
"{token}", where "token" is the type of permission needed interpreted as 
follows: 


00400 ~=Read by user 
00200 Write by user 
00040 Read by group 
00020 Write by group 
00004 Read by others 
00002 Write by others 


Read and write permissions on a shmid are granted to a process if one or more 
of the following are true: 


e The effective user ID of the process 1s super- user. 


e The effective user ID of the process matches shm_perm.cuid or 
shm_perm.uid in the data structure associated with shmid and the 
appropriate bit of the “‘user’’ portion (0600) of shm_perm.mode is set. 


e The effective group ID of the process matches shm_perm.cgid or 
shm_perm.gid and the appropriate bit of the “‘group’’ portion (060) of 
shm_perm.mode is set. 


e The appropriate bit of the ‘‘other’’ portion (06) of shm_perm.mode is 


set. 
Otherwise, the corresponding permissions are denied. 


STREAMS A set of kernel mechanisms that support the development of network 
services and data communication drivers. It defines interface standards for 
character input/output within the kernel and between the kernel and user level 
processes. The STREAMS mechanism is composed of utility routines, kernel 
facilities and a set of data structures. 


Stream A stream is a full-duplex data path within the kernel between a user 
process and driver routines. The primary components are a stream head, a 
driver and zero or more modules between the stream head and driver. A stream 
is analogous to a shell pipeline except that data flow and processing are 
bidirectional. 
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Stream Head In a stream, the stream head 1s the end of the stream that 
provides the interface between the stream and a user process. The principle 
functions of the stream head are processing STREAMS-related system calls, and 
passing data and information between a user process and the stream. 


Driver In a stream, the driver provides the interface between peripheral 
hardware and the stream. A driver can also be a pseudo-driver, such as a 
multiplexor or log driver [see log(7)], which is not associated with a hardware 
device. 


Module A module is an entity containing processing routines for input and 
Output data. It always exists in the middle of a stream, between the stream’s 
head and a driver. A module is the STREAMS counterpart to the commands in a 
Shell pipeline except that a module contains a pair of functions which allow 
independent bidirectional (downstream and upstream) data flow and 
processing. 


Downstream In a stream, the direction from stream head to driver. 
Upstream In a stream, the direction from driver to stream head. 


Message In a stream, one or more blocks of data or information, with 

associated STREAMS control structures. Messages can be of several defined 

types, which identify the message contents. Messages are the only means of fs 
transferring data and communicating within a stream. . 


Message Queue In a stream, a linked list of messages awaiting processing by a 
module or driver. 


Read Queue In a stream, the message queue in a module or driver containing 
messages Moving upstream. 


Write Queue In a stream, the message queue in a module or driver containing 
messages moving downstream. 


Multiplexor A multiplexor is a driver that allows streams associated with 
several user processes to be connected to a single driver, or several drivers to be 
connected to a single user process. STREAMS does not provide a general 
multiplexing driver, but does provide the facilities for constructing them, and 
for connecting multiplexed configurations of streams. 


Sockets and Address Families 
A socket is an endpoint for communication between processes. Each socket has 
queues for sending and receiving data. 


Sockets are typed according to their communications properties. These 
properties include whether messages sent and received at a socket require the 
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name of the partner, whether communication is reliable, the format used in 
naming message recipients, etc. 


Each instance of the system supports some collection of socket types; consult 
socket(2) for more information about the types available and their properties. 


Each instance of the system supports some number of sets of communications 
protocols. Each protocol set supports addresses of a certain format. An 
Address Family is the set of addresses for a specific group of protocols. Each 
socket has an address chosen from the address family in which the socket was 
created. 


Two interchangeable structures are used by socket calls: sockaddr (defined in 
<sys/socket.h>) and sockaddr in (defined in <sys/in.h>). The sa_data field of 
the sockaddr structure is interpreted according to the address family. (Note that 
AF INET is the only currently supported address family.) The structure 
sockaddr in has been defined specifically for the Internet family (the first field 
must be AF_INET); this structure is described in inet(7). 


SEE ALSO 
close(2), exit(2), getmsg(2), getpid(2), getuid(2), msgctl(2), msgget(2), 
msgop(2), open(2), poll(2), putmsg(2), read(2), semctl(2), semget(2), semop(2), 
setpgrp(2), setuid(2), shmctl(2), shmget(2), shmop(2), signal(2), wait(2), 
write(2), intro(3). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 
UNIX System V Release 3.2 Streams Programmer's Guide. 
UNIX System V Release 3.2 Streams Primer. 
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ACCESS (2) 


access - determine accessibility of a file 


SYNOPSIS 


int access (path, amode) 


char *path; 
int amode; 


DESCRIPTION 


The path argument points to a path name naming a file; access checks the 
named file for accessibility according to the bit pattern contained in amode, 
using the real user ID in place of the effective user ID and the real group ID in 
place of the effective group ID. The bit pattern contained in amode is 
constructed as follows: 


04 
02 
01 
00 


read 

write 

execute (search) 
check existence of file 


Access to the file is denied if one or more of the following are true: 


[ENOTDIR] 
[ENOENT] 


[ENOENT] 
[EACCES] 


[EROFS] 


[ETXTBSY] 


[EACCES] 


[EFAULT] 


[EINTR] 
[ENOLINK] 


A component of the path prefix is not a directory. 


Read, write, or execute (search) permission is requested for a 
null path name. 


The named file does not exist. 


Search permission is denied on a component of the path 
prefix. 


Write access is requested for a file on a read-only file 
system. 

Write access is requested for a pure procedure (shared text) 
file that is being executed. 


Permission bits of the file mode do not permit the requested 
access, 


Path points outside the allocated address space for the 
process. 


A signal was caught during the access system call, 


Path points to a remote machine and the link to that machine 
is no longer active. 
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{EMULTIHOP}] Components of path require hopping to multiple remote 
machines. 


The owner of a file has permission checked with respect to the “‘owner’’ read, 
write, and execute mode bits. Members of the file’s group other than the owner 
have permissions checked with respect to the ‘‘group’’ mode bits, and all others 
have permissions checked with respect to the ‘‘other’’ mode bits. 


SEE ALSO 
chmod(2), stat(2). 


DIAGNOSTICS 
If the requested access is permitted, a value of 0 is returned. Otherwise, a value 
of -1 is returned and errno is set to indicate the error. 
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NAME 
acct - enable or disable process accounting 


SYNOPSIS 
int acct (path) 
char *path; 


DESCRIPTION 
acct is used to enable or disable the system process accounting routine. If the 
routine is enabled, an accounting record will be written on an accounting file 
for each process that terminates. Termination can be caused by one of two 
things: an exit call or a signal [see exit(2) and signal(2)]. The effective user ID 
of the calling process must be super- user to use this call. 


path points to a pathname naming the accounting file. The accounting file 
format is given in acct(4). 


The accounting routine is enabled if path is non-zero and no errors occur 
during the system call. It is disabled if path is zero and no errors occur during 
the system call. 


acct will fail if one or more of the following are true: 


[EPERM] The effective user of the calling process is not super- user. 
[EBUSY] An attempt is being made to enable accounting when it is 
already enabled. 
[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] One or more components of the accounting file path name do 
not exist. 
[EACCES] The file named by path is not an ordinary file. 
[EROFS] The named file resides on a read-only file system. 
(EFAULT] Path points to an illegal address. 
SEE ALSO 
exit(2), signal(2), acct(4). 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 
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NAME 
adjtime - correct the time to allow synchronization of the system clock 


SYNOPSIS 
#include <sys/time.h> 


int adjtime(delta, olddelta) 
Struct timeval *delta; 
struct timeval *olddelta; 


DESCRIPTION 

The adjtime call makes small adjustments to the system time, as returned by 
gettimeofday (2), advancing or retarding it by the time specified by the timeval 
delta. If delta is negative, the clock is slowed down by incrementing it more 
slowly than normal until the correction is complete. If delta is positive, a larger 
increment than normal is used, The skew used to perform the correction is 
generally a fraction of one percent. Thus, the time is always a monotonically 
increasing function. 


This call can be used by time servers that synchronize the clocks of computers 
in a local area network. Such time servers would slow down the clocks of some 
machines and speed up the clocks of others to bring them to the average 
network time. 


RETURN VALUE 
A return value of O indicates that the call succeeded. A return value of -1 
indicates that an error occurred, and in this case an error code is stored in the 
global variable errno. 


ERRORS 
The following error codes may be set in errno: 


[EFAULT] An argument points outside the process’s allocated address 
space. 
[EPERM] The process’s effective user ID is not that of the super-user. 
SEE ALSO 
date(1), getttmeofday(2). 
WARNINGS 


A time correction from an earlier call to adjtime may not be finished when 
adjtime is called again. If olddelta is non-zero, then the structure pointed to 
will contain, upon return, the number of microseconds still to be corrected from 
the earlier call. 


The adjtime (2) call is restricted to the super-user. 
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NAME 
alarm - set a process alarm clock 


SYNOPSIS 
unsigned alarm (sec) 
unsigned sec; 


DESCRIPTION 
alarm instructs the alarm clock of the calling process to send the signal 
SIGALRM to the calling process after the number of real time seconds specified 
by sec have elapsed [see signal (2)}. 
Alarm requests are not stacked; successive calls reset the alarm clock of the 
calling process. 


If sec is O, any previously made alarm request is canceled. 
SEE ALSO 
pause(2), signal(2), sigpause(2). 


DIAGNOSTICS 
alarm returns the amount of time previously remaining in the alarm clock of the 
calling process. 
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NAME 


(CTIX Internetworking ) BIND (2) 


bind - bind a name to a socket 


SYNOPSIS 


#include <sys/types.h> 


#include <sys/socket.h> 


int bind (s, name, namelen) 


int Ss; 


struct sockaddr *name; 


int namelen; 


DESCRIPTION 


The bind call assigns a name to an unnamed socket. When a socket is created 
with socket(2), it exists in a name space (address family) but has no name 
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call requests that name be assigned to the socket. 


SEE ALSO 


connect(2), getsockname(2), intro(2), listen(2), socket(2), inet(7), intro(7). 
CTIX Network Programmer's Primer. 


NOTES 


The rules used in name binding vary between communication domains [see 
protocols(4)}. Consult the manual entries in Section 7 for detailed information. 


RETURN VALUE 


If the bind is successful, a 0 value is returned. A return value of -1 indicates an 
error, which is further specified in the global errno. 


ERRORS 


The bind call fails if any of the following are true: 


[EBADF] 
{[ENOTSOCK] 
[EADDRNOTAVAIL] 


{EADDRINUSE] 
[EINVAL] 
[EACCESS] 


[EFAULT] 


§ is not a valid descriptor. 
S is not a socket. 


The specified address is not available from the local 
machine. 


The specified address is already in use. 
The socket is already bound to an address. 


The requested address is protected, and the current 
user has inadequate permission to access it. 


The name parameter is not in a valid part of the user 
address space. 
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brk, sbrk - change data segment space allocation 


SYNOPSIS 


int brk (endds) 
char *endds; 


char *sbrk (incr) 
int incr; 


DESCRIPTION 


brk and sbrk are used to change dynamically the amount of space allocated for 
the calling process’s data segment [see exec(2)]. The change is made by 
resetting the process’s break value and allocating the appropriate amount of 
space. The break value is the address of the first location beyond the end of the 
data seoment, The amount of allocated snace increases as the break valuc 
increases. Newly allocated space is set to zero. If, however, the same memory 
space is reallocated to the same process its contents are undefined. 


brk sets the break value to endds and changes the allocated space accordingly. 


sbrk adds incr bytes to the break value and changes the allocated space 
accordingly. Jncr can be negative, in which case the amount of allocated space 
is decreased. 


brk and sbrk will fail without making any change in the allocated space if one 
or more of the following are true: 


[ENOMEM] Such a change would result in more space being allocated 
than is allowed by the system-imposed maximum process 
size [see ulimit (2)]. 


[EAGAIN] Total amount of system memory available for a read during 
physical I/O is temporarily insufficient [see shmop(2)]. This 
may occur even though the space requested was less than the 
system-imposed maximum process size [see ulimit(2)]. 


SEE ALSO 


exec(2), shmop(2), ulimit(2), end(3C). 


DIAGNOSTICS 


Upon successful completion, brk returns a value of 0 and sbrk returns the old 
break value. Otherwise, a value of -1 is returned and errno is set to indicate the 
error. 
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NAME 


CHDIR (2) 


chdir - change working directory 


SYNOPSIS 


int chdir (path) 
char *path; 


DESCRIPTION 
Path points to the path name of a directory. chdir causes the named directory 
to become the current working directory, the starting point for path searches for 
path names not beginning with /. 


chdir will fail and the current working directory will be unchanged if one or 
more of the following are true: 


[ENOTDIR] 


[ENOENT] 
[EACCES} 


[EFAULT] 


{[EINTR] 


[ENOLINK} 


[EMULTIHOP] 


SEE ALSO 
ehr 


wiih 
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DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


A component of the path name is not a directory. 
The named directory does not exist. 


Search permission is denied for any component of the path 
name. 


Path points outside the allocated address space of the 
process. 


A signal was caught during the chdir system call. 


Path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 
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NAME 


chmod - change mode of file 


SYNOPSIS 


int chmod (path, mode) 
char *path; 
int mode; 


DESCRIPTION 


Path points to a path name naming a file. chmod sets the access permission 
portion of the named file’s mode according to the bit pattern contained in mode. 


Access permission bits are interpreted as follows: 
04000 Set user ID on execution. 


O20#0 Set group ID on execution if # is 7, 5,3, or 1 
Enable mandatory file/record locking if # 1s 6, 4, 2, or 0 


01000 Save text image after execution. 

00400 Read by owner. 

00200 Write by owner. 

00100 Execute (search if a directory) by owner. 
00070 Read, write, execute (search) by group. 

00007 Read, write, execute (search) by others. 


The effective user ID of the process must match the owner of the file or be 
super-user to change the mode of a file. 


If the effective user ID of the process is not super-user, mode bit 01000 (save 
text image on execution) 1s cleared. 


If the effective user ID of the process is not super-user and the effective group 
ID of the process does not match the group ID of the file, mode bit 02000 (set 
group ID on execution) is cleared. 


If a 410 executable file has the sticky bit (mode bit 01000) set, the operating 
system does not delete the program text from the swap area when the last user 
process terminates. If a 413 executable file has the sticky bit set, the operating 
system does not delete the program text from memory when the last user 
process terminates. In either case, if the sticky bit is set the text is already be 
available (either in a swap area or in memory) when the next user of the file 
executes it, thus making execution faster. 
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Overall, if a directory is writable and has the sticky bit set, files within that 
directory can be removed only if one or more of the following is true [see 


unlink(2)}: 


the user owns the file 

the user owns the directory 
the file is writable to the user 
the user 1s the super-user 


If the mode bit 02000 (set group ID on execution) 1s set and the mode bit 00010 
(execute or search by group) is not set, mandatory file/record locking exists on 
a regular file. This can affect future calls to open(2), creat(2), read(2), and 
write(2) on this file. 


The chmod fails and the file mode is unchanged if one or more of the following 


nan wash 


[ENOTDIR] 


[ENOENT] 
[EACCES] 


[EPERM] 


[EROFS] 
[EFAULT] 


[EMULTTHOP] 


SEE ALSO 


A component of the path prefix is not a directory. 
The named file does not exist. 


Search permission is denied on a component of the path 
prefix. 


The effective user ID does not match the owner of the file 
and the effective user ID is not super- user. 


The named file resides on a read-only file system. 


Path points outside the allocated address space of the 
process. 


A signal was caught during the chmod system call. 
Path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 


chmod(1), chown(2), creat(2), fcntl(2), mknod(2), open(2), read(2), write(2). 


DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


CHOWN (2) 


chown - change owner and group of a file 


SYNOPSIS 
int chown (path, owner, group) 


char *path; 


int owner, group; 


DESCRIPTION 
The path argument points to a path name naming a file. The owner ID and 
group ID of the named file are set to the numeric values contained in owner and 
group respectively. 


Only processes with effective user ID equal to the file owner or super- user may 
change the ownership of a file. 


if chown is invoked by other than the super-user, the set-user-ID and set- 
group-ID bits of the file mode, 04000 and 02000 respectively, are cleared. 


The chown call fails and the owner and group of the named file remains 
unchanged if one or more of the following are true: 


[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] The named file does not exist. 
{[EACCES] Search permission is denied on a component of the path 
prefix. 
(EPERM] The effective user ID does not match the owner of the file 
and the effective user ID is not super- user. 
[EROFS] The named file resides on a read-only file system. 
fEFAULT] Path points outside the allocated address space of the 
process. 
[EINTR] A signal was caught during the chown system call. 
[ENOLINK] Path points to a remote machine and the link to that machine 
is no longer active. 
[EMULTIHOP] Components of path require hopping to multiple remote 
machines. 
SEE ALSO 
chown(1), chmod(2). 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 
chroot - change root directory 


SYNOPSIS 
int chroot (path) 
char *path; 


DESCRIPTION 
The path argument points to a path name naming a directory. The chroot call 
causes the named directory to become the root directory, the starting point for 
path searches for path names beginning with root (/). The user’s working 
directory is unaffected by the chroot system call. 


The effective user ID of the process must be super-user to change the root 
directory. 


The .. entry in the root directory is interpreted to mean the root directory itself. 
Thus, .. cannot be used to access files outside the subtree rooted at the root 
directory. 


The chroot call fails and the root directory remains unchanged if one or more of 
the following are true: 


[ENOTDIR] Any component of the path name is not a directory. 
[ENOENT] The named directory does not exist. 
[EPERM] The effective user ID is not super- user. 
(EFAULT] Path points outside the allocated address space of the 
process. 
[EINTR] A signal was caught during the chroot system call. 
[ENOLINK] Path points to a remote machine and the link to that machine 
is no longer active. 
[EMULTIHOP] Components of path require hopping to multiple remote 
machines. 
SEE ALSO 
chdir(2). 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 
Close - close a file descriptor 


SYNOPSIS 
int close (fildes) 
int fildes; 


DESCRIPTION 
fildes is a file descriptor obtained from a creat, open, dup, fcntl, or pipe system 
call. close closes the file descriptor indicated by fildes. All outstanding record 
locks owned by the process (on the file indicated by fildes) are removed. 


If a STREAMS [see intro(2)] file is closed, and the calling process had 
previously registered to receive a SIGPOLL signal [see signal(2) and sigset(2)] 
for events associated with that file [see I_SETSIG in streamio(7)], the calling 
process will be unregistered for events associaied wiih ihe file. The iast ciose 
for a stream causes the stream associated with fildes to be dismantled. If 
O_NDELAY is not set and there have been no signals posted for the stream, 
close waits up to 15 seconds, for each module and driver, for any output to drain 
before dismantling the stream. If the O_NDELAY flag is set or if there are any 
pending signals, close does not wait for output to drain, and dismantles the 
stream immediately. 


The named file is closed unless one or more of the following are true: 


(EBADF] fildes is not a valid open file descriptor. 
{EINTR] A signal was caught during the close system call. 
(ENOLINK] fildes is on a remote machine and the link to that machine is 
no longer active. 
SEE ALSO 
creat(2), dup(2), exec(2), fcentl(2), intro(2), open(2), pipe(2), signal(2), sigset(2), 
streamio(7), 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno 1s set to indicate the error. 
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connect - initiate a connection on a socket 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/socket.h> 


int connect (s, name, namelen) 
int s; 

struct sockaddr *name; 

int namelen; 


DESCRIPTION 


The connect call initiates a connection on a socket. The parameter s is a socket. 
If it is of type SOCK_DGRAM, then this call pemanney Speen the peer to 
which datagrams ar are to be sent; if it is of type SCCK_STREAM, ihen this call 
attempts to make a connection to another socket. The other socket is specified 
by name; namelen is the length of name, which is an address in the address 
family of the socket. Each address family interprets the name parameter in its 
Own way. 


RETURN VALUE 


If the connection or binding succeeds, then 0 is returned. Otherwise a -1 is 
returned, and a more specific error code is stored in errno. 


ERRORS 


The call fails if: 
[EBADF] S is not a valid descriptor. 
[ENOTSOCK] S is a descriptor for a file, not a socket. 


[EADDRNOTAVAIL] _ The specified address is not available on this machine. 


[EAFNOSUPPORT] Addresses in the specified address family cannot be 
used with this socket. 


[EISCONN] The socket is already connected. 


[ETIMEDOUT] Connection establishment timed out without 
establishing a connection. 


[ECONNREFUSED] The attempt to connect was forcefully rejected. 


[ENETUNREACH] The network is not reachable from this host. 
[EADDRINUSE] The address is already in use. 
[EFAULT] The name parameter specifies an area outside the 


process address space. 
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SEE ALSO 
accept(2), getsockname(2), intro(2), socket(2), intro(7). 
CTIX Network Programmer’ s Primer. 
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NAME 


creat - create a new file or rewrite an existing one 


SYNOPSIS 


int creat (path, mode) 
char *path; 
int mode; 


DESCRIPTION 


The creat call creates a new ordinary file or prepares to rewrite an existing file 
named by the path name pointed to by path. 


If the file exists, the length is truncated to 0 and the mode and owner are 
unchanged. Otherwise, the file’s owner ID is set to the effective user ID of the 
process, the group ID of the process is set to the effective group ID of the 
process, and the low-order 12 bits of the file mode are set to the valuc of mode 
modified as follows: 


@ All bits set in the process’s file mode creation mask are cleared [see 
umask (2)}. 

e The “‘save text image after execution bit’’ of the mode is cleared [see 
chmod (2)]. 


Upon successful completion, a write-only file descriptor is returned and the file 
is open for writing, even if the mode does not permit writing. The file pointer is 
set to the beginning of the file. The file descriptor is set to remain open across 
exec system calls [see fentl(2)]. No process can have more than NOFILES files 
open simultaneously. NOFILES is a system-imposed maximum per process, 
which can be changed by uconf(1M): the range, as specified in param.h, is 20 
(NOFILES_MIN) to 100 (NOFILES_MAX). The current value of NOFILES can be 
determined by ulimit(2). A new file can be created with a mode that forbids 
writing. 


The creat call fails if one or more of the following are true: 


[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] A component of the path prefix does not exist. 

[EACCES] Search permission is denied on a component of the path 
prefix. 

[ENOENT] The path name is null. 

[EACCES] The file does not exist and the directory in which the file is 


to be created does not permit writing. 
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[EROFS] 


[ETXTBSY] 


{[EACCES] 
[EISDIR] 

[EMFILE] 
[EFAULT] 


[ENFILE] 
[EAGAIN] 


[EINTR] 
[ENOLINK] 


[EMULTIHOP] 


[ENOSPC] 
[EDEADLOCK] 


SEE ALSO 


CREAT (2) 


The named file resides or would reside on a read-only file 
system. 


The file is a pure procedure (shared text) file that is being 
executed. 


The file exists and write permission is denied. 
The named file is an existing directory. 
NOFILES file descriptors are currently open. 


Path points outside the allocated address space of the 
process. 


The system file table is full. 


The file exists, mandatory file/record locking is set, and there 
are outstanding record locks on the file [see chmod(2)}. 


A signal was caught during the creat system call. 


Path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 


The file system is out of inodes. 


A side effect of a previous locking(2) call. [See the 
WARNING on the locking (2) manpage.] 


chmod(2), close(2), dup(2), fentl(2), lseek(2), open(2), read(2), umask(2), 


write(2). 


DIAGNOSTICS 


Upon successful completion, a non-negative integer, namely the file descriptor, 
is returned. Otherwise, a value of -1 1s returned and errno is set to indicate the 


error. 
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NAME 
dup - duplicate an open file descriptor 


SYNOPSIS 
int dup (fildes) 
int fildes; 


DESCRIPTION 
fildes is a file descriptor obtained from a creat, open, dup, fcntl, or pipe system 
call. dup returns a new file descriptor having the following in common with the 
original: 
e Same open file (or pipe). 
e Same file pointer (that is, both file descriptors share one file pointer). 
e Same access mode (read, write or read/write). 


The new file descriptor is set to remain open across exec system calls [see 


fentl (2)}. 
The file descriptor returned is the lowest one available. 


dup will fail if one or more of the following are true: 


[EBADF] fildes is not a valid open file descriptor. 
[EINTR] A signal was caught during the dup system call. 
[EMFILE] NOFILES file descriptors are currently open. 
[ENOLINK] fildes is on a remote machine and the link to that machine is 
no longer active. 
SEE ALSO 
close(2), creat(2), exec(2), fentl(2), open(2), pipe(2), lockf£(3C) 
DIAGNOSTICS 


Upon successful completion a non-negative integer, namely the file descriptor, 
is returned. Otherwise, a value of -1 is returned and errno 1s set to indicate the 
error. 
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NAME 


exec: execl, execv, execle, execve, execlp, execvp - execute a file 


SYNOPSIS 


int execl (path, arg0, arg], .... argn, (char *)0) 
char +path, *arg0, *argl, .... *argn; 

int execv (path, argv) 

char *path, *argv[ ]; 

int execle (path, arg0, argl, ..., argn, (char *)0, envp) 
char *path, *arg0, *argl, .... *argn, *envp[ ]; 
int execve (path, argy, envp) 

char *path, *argv[ ], *envp[ J; 

int execip (file, arg, argi, .... argn, (char *)0) 
char #file, *arg0, *argl, ..., *argn; 

int execvp (file, argv) 

char *file, *argy[ }; 


DESCRIPTION 


The exec call in all its forms transforms the calling process into a new process. 
The new process is constructed from an ordinary, executable file called the new 
process file. This file consists of a header [see a.out(4)}, a text segment, and a 
data segment. The data segment contains an initialized portion and an 
uninitialized portion (bss). There can be no return from a successful exec 
because the calling process is overlaid by the new process. 


When a C program is executed, it is called as follows: 


main (argc, argv, envp) 

int argc; 

char **argv, **envp; 
where argc is the argument count, argv is an array of character pointers to the 
arguments themselves, and envp is an array of character pointers to the 
environment strings. As indicated, argc is conventionally at least one and the 
first member of the array points to a string containing the name of the file. 


Path points to a path name that identifies the new process file. 


File points to the new process file. The path prefix for this file is obtained by a 
search of the directories passed as the environment line PATH [see environ (5)]. 
The environment is supplied by the shell [see sh(1)]. 
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arg0, arg], ..., argn are pointers to null-terminated character strings. These 
strings constitute the argument list available to the new process. By 
convention, at least argO must be present and point to a string that is the same 
as path (or its last component). 


argv is an array of character pointers to null-terminated strings. These strings 
constitute the argument list available to the new process. By convention, argv 
must have at least one member, and it must point to a string that 1s the same as 
path (or its last component). argv is terminated by a null pointer. 


envp is an array of character pointers to null-terminated strings. These strings 
constitute the environment for the new process. envp is terminated by a null 
pointer. For execl and execv, the C run-time start-off routine places a pointer 
to the environment of the calling process in the global cell: 


extern char **environ; 
It is used to pass the environment of the calling process to the new process. 


File descriptors open in the calling process remain open in the new process, 
except for those whose close-on-exec flag is set; see fentl(2). For those file 
descriptors that remain open, the file pointer is unchanged. 


Signals set to terminate the calling process are set to terminate the new process. 
Signals set to be ignored by the calling process are set to be ignored by the new 
process. Signals set to be caught by the calling process are set to terminate the 
new process; see signal (2). 


For signals set by sigset(2), exec ensures that the new process has the same 
system signal action for each signal type whose action is SIG_DFL, SIG_IGN, or 
SIG_HOLD as the calling process. However, if the action 1s to catch the signal, 
then the action is reset to SIG_DFL, and any pending signal for this type is held. 


If the set-user-ID mode bit of the new process file 1s set [see chmod(2)], exec 
sets the effective user ID of the new process to the owner ID of the new process 
file. Similarly, if the set-group-ID mode bit of the new process file is set, the 
effective group ID of the new process is set to the group ID of the new process 
file. The real user ID and real group ID of the new process remain the same as 
those of the calling process. 


The shared memory segments attached to the calling process are not attached to 
the new process [see shmop (2)]. 


Profiling is disabled for the new process; see profil (2). 
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The new process also inherits the following attributes from the calling process: 


nice value [see nice (2)} 

process ID 

parent process ID 

process group ID 

semadj values [see semop(2)] 

tty group ID [see exit(2) and signal (2)] 

trace flag [see ptrace (2) request 0] 

time left until an alarm clock signal [see alarm(2)] 
current working directory 

root directory 

file mode creation mask [see umask(2)] 

file size limit [see ulimit (2)] 

utime, stime, cutime, and cstime [see times(2)] 
file- locks [see fentl(2) and lockf{(3C)} 


exec fails and returns to the calling process if one or more of the following are 


true: 
[ENOENT} 


[ENOTDIR] 


[EACCES] 


[EACCES] 


[EACCES] 


[ENOEXEC] 


[ETXTBSY)] 


[ENOMEM] 


[E2BIG] 


(EFAULT] 


One or more components of the new process path name of 
the file do not exist. 


A component of the new process path of the file prefix is not 
a directory. 


Search permission is denied for a directory listed in the new 
process file’s path prefix. 


The new process file is not an ordinary file. 
The new process file mode denies execution permission. 


The exec is not an execlp or execvp , and the new process file 
has the appropriate access permission but an invalid magic 
number in its header. 


The new process file is a pure procedure (shared text) file 
that is currently open for writing by some process. 


The new process requires more memory than is allowed by 
the system-imposed maximum MAXMEM. 


The number of bytes in the new process’s argument list is 
greater than the system-imposed limit of 10,240 bytes. 


Path, argv, or envp point to an illegal address. 
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[EAGAIN] 
[ELIBACC} 
[ELIBEXEC] 
[EINTR] 
[ENOLINK] 


[EMULTIHOP] 


[ENOHDW] 


[ENOFXEC] 


[ENOEXEC] 


SEE ALSO 
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Not enough memory. 

Required shared library does not have execute permission. 
Trying to exec(2) a shared library directly. 

A signal was caught during the exec system call. 


Path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 


The executable file requires hardware that does not exist 
(such as floating-point). 

The file format does not correspond to that expected as 
specified with the magic number (such as a hole in the file). 


The virtual address specification in the header(s) exceeds the 
allowed system limits. 


alarm(2), exit(2), fcntl(2), fork(2), nice(2), ptrace(2), semop(2), signal(2), 
sigset(2), times(2), ulimit(2), umask(2), lockf(3C), a.out(4), environ(5). 


DIAGNOSTICS 


If exec returns to the calling process an error has occurred; the return value is 
-1 and errno is set to indicate the error. 
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NAME 
exit, 
SYNOPSIS 


EXIT (2) 


exit - terminate process 


void exit (status) 
int status; 

void exit (status) 
int status; 


DESCRIPTION 


The exit call terminates the calling process with the following consequences: 


All of the file descriptors open in the calling process are closed. 


If the parent process of the calling process is executing a wait, it is 
notified of the calling process’s termination and the low order eight 
bits (bits 0377) of status are made available to it [see wait (2)}. 


If the parent process of the calling process is not executing a wait, the 
calling process is transformed into a zombie process. A zombie 
process \s a process that only occupies a slot in the process table. It 
has no other space allocated either in user or kernel space. The 
process table slot that it occupies is partially overlaid with time 
accounting information (see <sys/proc.h>) to be used by times. 


The parent process ID of all of the calling processes’ existing child 
processes and zombie processes is set to 1. This means the 
initialization process [see intro(2)] inherits each of these processes. 


Each attached shared memory segment is detached and the value of 
shm_nattach in the data structure associated with its shared memory 
identifier is decremented by 1. 


For each semaphore for which the calling process has set a semadj 
value [see semop(2)], that semadj value is added to the semval of the 
specified semaphore. 


If the process has a process, text, or data lock, an unlock is performed 
[see plock(2)]}. 


An accounting record is written on the accounting file if the system’s 
accounting routine is enabled [see acct (2)]. 


If the process ID, tty group ID, and process group ID of the calling 
process are equal (it is a process group leader), the SIGHUP signal is 
sent to each process that has a process group ID equal to that of the 
calling process. 
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° A death of child signal is sent to the parent. 
e The C function exit may cause cleanup actions before the process 
exits. The function exif circumvents all cleanup. 

SEE ALSO 

acct(2), intro(2), plock(2), semop(2), signal(2), sigset(2), wait(2). 
DIAGNOSTICS 

None. There can be no return from an exit system call. 
WARNING 


See WARNING in signal(2). 
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NAME 


FCNTL(2) 


fenti - file control 


SYNOPSIS 


#include <fcentl.h> 


int fcntl (fildes, cmd, arg) 
int fildes, cmd, arg; 


DESCRIPTION 


The fentl call provides for control over open files. fildes is an open file 
descriptor obtained from a creat, open, dup, fentl, or pipe system call. 


The data type, value, and use of arg are specific to the type of command 
specified by cmd. cmd specifies the operation to be performed by fenél, and can 
be one of the following: 


The commands available are: 


F_DUPFD 


F_GETFD 


F_SETFD 


F_GETFL 
F_SETFL 


Return a new file descriptor as follows: 


Lowest numbered available file descriptor greater than or 
equal to arg. 


Same open file (or pipe) as the original file. 


Same file pointer as the original file (that is, both file 
descriptors share one file pointer). 


Same access mode (read, write or read/write). 


Same file status flags (that is, both file descriptors share the 
same file status flags). 


The close-on-exec flag associated with the new file descriptor 
is set to remain Open across exec (2) system calls. 


Get the close-on-exec flag associated with the file descriptor 
fildes. If the low-order bit is 0 the file will remain open 
across exec, otherwise the file will be closed upon execution 
of exec. 


Set the close-on-exec flag associated with fildes to the low- 
order bit of arg (0 or 1 as above). 


Get file status flags. 


Set file status flags to arg. Only certain flags can be set [see 
fentl (5)). 
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F_GETLK Get the first lock which blocks the lock description given by 
the variable of type struct flock pointed to by arg. The 
information retrieved overwrites the information passed to 
fentl in the flock structure. If no lock is found that would 
prevent this lock from being created, then the structure is 
passed back unchanged except for the lock type which will be 
set to FLUNLCK. 


F_SETLK Set or clear a file segment lock according to the variable of 
type struct flock pointed to by arg [see fcntl(5)]. The cmd 
F_SETLK is used to establish read (F_RDLCK) and write 
(F_WRLCK) locks, as well as remove either type of lock 
(F_LUNLCK). If a read or write lock cannot be set fentl will 
return immediately with an error value of -1. 


F_SETLKW This cmd is the same as F_SETLK except that 1f a read or write 
lock is blocked by other locks, the process will sleep until the 
segment is free to be locked. 


A read lock prevents any process from write locking the protected area. More 
than one read lock may exist for a given segment of a file at a given time. The 
file descriptor on which a read lock is being placed must have been opened with 
read access. 


A write lock prevents any process from read locking or write locking the 
protected area. Only one write lock may exist for a given segment of a file ata 
given time. The file descriptor on which a write lock 1s being placed must have 
been opened with write access. 


The structure flock describes the type (/ type), starting offset (1 whence), 


relative offset ( start), size (1 len), process ID (1 pid), and RFS system ID 
(l_sysid) of the segment of the file to be affected. The process ID and system ID 
fields are used only with the F_LGETLK cmd to return the values for a blocking 
lock. Locks may start and extend beyond the current end of a file, but may not 
be negative relative to the beginning of the file. A lock may be set to always 
extend to the end of file by setting / len to zero (0). If such a lock also has 
1 whence and ! start set to zero (0), the whole file will be locked. Changing or 
unlocking a segment from the middle of a larger locked segment leaves two 
smaller segments for either end. Locking a segment that is already locked by 
the calling process causes the old lock type to be removed and the new lock 
type to take effect. All locks associated with a file for a given process are 
removed when a file descriptor for that file is closed by that process or the 
process holding that file descriptor terminates. Locks are not inherited by a 
child process in a fork(2) system call. 
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When mandatory file and record locking is active on a file, [see chmod (2)}, 
read and write system Calls issucd on the file are affected by the record locks in 


effect. 


The fcnél call fails if one or more of the following are true: 


[EBADF] 
[EBADF] 


[EBADF] 


[EMFILE] 


[EINVAL] 


[EINVAL] 


[EACCES] 


[ENOLCK] 


[EDEADLK] 


[EFAULT] 


[EINTR] 
[ENOLINK] 


fildes is not a valid open file descriptor. 

cmd is F_LSETLK or F_LSETLKW the type of lock (/ type) is a 
read lock (F_RDLCK) and fildes is not a valid open file 
descriptor open for reading. 


cmd is F_SETLK or F_LSETLKW the type of lock (/_type) is a 
write lock (F_RDLCK) and fildes is not a valid open file 
descriptor open for writing. 

cmd is F_DUPFD and the number of file descriptors currenily 
open in the calling process is the configured value for the 
maximum number of open file descriptors allowed each user. 


cmd is F_DUPFD. arg is either negative, or greater than or 
equal to the configured value for the maximum number of 
open file descriptors allowcd each user. 


cmd 1s F_GETLK, F_SETLK, or SETLKW and arg or the data it 
points to is not valid. 


cmd is F_SETLK the type of lock (i type) is a read 
(F_RDLCK) lock and the segment of a file to be locked is 
already write locked by another process or the type is a write 
(F_WRLCK) lock and the segment of a file to be locked is 
already read or write locked by another process. 


cmd is F_SETLK or F_SETLKW, the type of lock is a read or 
write lock, and there are no more record locks available (too 
many file segments locked) because the system maximum 
has been excecded. 


cmd is F_LSETLKW, the lock is blocked by some lock from 
another process, and putting the calling- process to sleep, 
waiting for that lock to become free, would cause a deadlock. 


cmd is F_SETLK, arg points outside the program address 
space. 


A signal was caught during the fenél system call. 


fildes is on a remote machine and the link to that machine is 
no longer active. 


i 
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SEE ALSO 
close(2), creat(2), dup(2), exec(2), fork(2), open(2), pipe(2), fentl(5). 
DIAGNOSTICS 
Upon successful completion, the value returned depends on cmd as follows: 
F_DUPFD A new file descriptor. 
F_GETFD Valuc of flag (only the low-order bit 1s defined). 
F_SETFD Value other than -1. 
F_GETFL Value of file flags. 
F_SETFL Value other than - 1. 
F_GETLK Value other than - 1. 
F_SETLK Value other than - 1. 
F_SETLKW Value other than -1. 


Otherwise, a value of -1 is returned and errno is set to indicate the error. 


WARNINGS 
Because in the future the variable errno will be set to EAGAIN rather than 
EACCES when a section of a file is already locked by another process, portable 
application programs should expect and test for either value. 


Two forms of file locking are available: locking (2) and fentl(2). locking (2) 1s 
retained for compatibility with previous versions of CTIX. Although both forms 
are compatible and interchangeable, new programs should use only fentl (2) for 
record locking. Note that the error return valucs differ. 
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NAME 


FORK(2) 


fork - create a new process 


SYNOPSIS 


int fork () 


DESCRIPTION 


fork causes creation of a new process. The new process (child process) is an 
exact copy of the calling process (parent process). This means the child process 
inherits the following attributes from the parent process: 


environment 

close-on-exec flag [see exec (2)] 

signal handling settings (that is, SIG_DFL, SIG_IGN, SIG_HOLD, 
function address) 

set-user-ID mode bit 

Set-group-ID mode bit 

profiling on/off status 

nice value [see nice (2)] 

all attached shared memory segments [see shmop(2)] 
process group ID 

tty group ID [see exit(2)] 

Current working directory 

root directory 

file mode creation mask [see umask (2)] 

file size limit [see ulimit (2)] 


The child process differs from the parent process in the following ways: 


The child process has a unique process ID. 
The child process has a different parent process ID (that is, the process 
ID of the parent process). 


The child process has its own copy of the parent’s file descriptors. 
Each of the child’s file descriptors shares a common file pointer with 
the corresponding file descriptor of the parent. 


All semadj values are cleared [see semop(2)]. 


Process locks, text locks and data locks are not inherited by the child 
[see plock(2)]. 


The child process’s utime , stime, cutime , and cstime are set to 0. The 
time left until an alarm clock signal is reset to 0. 
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fork will fait and no child process will be created if one or more of the 
following are true: 


[EAGAIN] The system-imposed limit on the total number of processes 
under execution would be exceeded. 


[EAGAIN] The system-imposed limit on the total number of processes 
under execution by a single user would be exceeded. 


[EAGAIN] Total amount of system memory available when reading via 
raw IO is temporarily insufficient. 


SEE ALSO 


exec(2), nice(2), plock(2), ptrace(2), semop(2), shmop(2), signal(2), sigset(2), 
times(2), ulimit(2), umask(2), wait(2). 


Beam eA Se ee Se ee 


Upon successful completion, fork returns a value of 0 to the child process and 
returns the process ID of the child process to the parent process. Otherwise, a 
value of -1 is returned to the parent process, no child process is created, and 
errno 1S Set to indicate the error. 
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NAME 
getdents - read directory entries and put in a file system independent format 


SYNOPSIS 
#include <sys/dirent.h> 


int getdents (fildes, buf, nbyte) 
int fildes; 

char *buf; 

unsigned nbyte; 


DESCRIPTION 
The fildes argument is a file descriptor obtained from an open(2) or dup(2) 
system call. 


The getdents call attempts to read nbyte bytes from the directory associated 
with fiides and to format them as file system independent directory entries in 
the buffer pointed to by buf. Since the file system independent directory entries 
are of variable length, in most cases the actual number of bytes returned is 
strictly less than nbyte. 


The file system independent directory entry is specified by the dirent structure. 
For a description of this see dirent (4). 


On devices capable of seeking, getdents starts at a position in the file given by 
the file pomter associated with fildes. Upon return from getdents, the file 
pointer is incremented to point to the next directory entry. 


This system call was developed in order to implement the readdir (3X) routine 
[for a description see directory (3X)], and should not be used for other purposes. 


The getdents call fails if one or more of the following are true: 


([EBADF] fildes is nota valid file descriptor open for reading. 

[EFAULT] buf points outside the allocated address space. 

[EINVAL] nbyte is not large enough for one directory entry. 

[ENOENT] The current file pointer for the directory is not located at a 
valid entry. 

{ENOLINK] fildes points to a remote machine and the link to that 
machine is no longer active. 

(ENOTDIR] fildes is not a directory. 

[EIO} An J/O error occurred while accessing the file system. 

SEE ALSO 


directory(3X), dirent(4). 
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DIAGNOSTICS 
Upon successful completion a non-negative integer is returned indicating the 
number of bytes actually read. A value of 0 indicates the end of the directory 


has been reached. If the system call failed, a -1 is returned and errno is set to 
indicate the error. 
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NAME 
getdtablesize - get descriptor table size 


SYNOPSIS 
nfds = getdtablesize( ) 
int nfds; 


DESCRIPTION 
Each process has a fixed size descriptor table, which is guaranteed to have at 
least 20 slots. The size of the descriptor table determines how many files and 
sockets a process can have open simultaneously. The entries in the descriptor 
table are numbered with small integers starting at O. The call getdtablesize 
returns the size of this table. It is equivalent to the ulimit(2) system call as 
issued with an argument as shown below: 


nlimit/A\ 
QS RRAEEE EY 


SEE ALSO 
Close(2), dup(2), open(2), select(2), ulimit(2). 
CTIX Network Programmer’ s Primer. 
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NAME 
gethostid, sethostid - get/set unique identifier of current host 


SYNOPSIS 
hostid = gethostid() 
long hostid; 


sethostid(hostid) 
long hostid; 


DESCRIPTION 
The sethostid call establishes a 32-bit identifier for the current system that is 
intended to be unique among all UNIX systems in existence. This is normally a 
DARPA Internet address for the local machine. This call is allowed only to the 
super-user and is normally performed at boot time. The sethostid call returns an 


int -1 if the ID can not be set. 


The gethostid call returns the 32-bit identifier for the current processor. 


SEE ALSO 
hostid(1), gethostname(2). 
CTIX Network Programmer’ s Primer. 
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NAME 
gethostname, sethostname - get/set name of current host 


SYNOPSIS 
int gethostname(name, namelen) 
char *name; 
int namelen; 


int sethostname(name, namelen) 
char *name; 
int namelen; 


DESCRIPTION 
The gethostname call returns the standard host name for the current processor, 
as previously set by sethostname. The parameter namelen specifies the size of 


ite name array. The returned name is null-terminated unless insufficient space 
is provided. 


The sethostname call sets the name of the host machine to be name, which has 
length namelen. This call is restricted to the super-user and is normally used 
only when the system is booted up. In order to maintain consistency between 
the system nodename and the local hostname, sethostname interacts with 
setuname. See hostname (1) for the specifics. 


RETURN VALUE 
If the call succeeds a value of 0 is returned. If the call fails, then a value of -1 is 
returned and an error code is placed in the global location errno. 


ERRORS 
The following errors may be returned by these calls: 


[EFAULT] The name or namelen parameter gave an invalid address. 
[EPERM] The caller tried to set the hostname and was not the super- 
user. 
SEE ALSO 


hostname(1), uname(1), setuname(2), gethostid(2). 
CTIX Network Programmer's Primer. 


WARNING 
Host names are limited to MAXHOSTNAMELEN (from <sys/param.h>) 
characters, currently 64. The left-most qualifier, or nodename, is limited to the 
size of a system nodename, currently 9 characters. The right-most qualifier, or 
Internet Domain name, is limited to 54 characters. 
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NAME 
getmsg - get next message off a stream 


SYNOPSIS 
#include <stropts.h> 


int getmsg(fd, ctlptr, dataptr, flags) 
int fd; 

struct strbuf *ctlptr; 

struct strbuf *dataptr; 

int *flags; 


DESCRIPTION 
getmsg retrieves the contents of a message [see iniro(2)] located at the stream 
head read queue from a STREAMS file, and places the contents into user 
specificd buffer(s). The message musi coniain either a data part, a control part 
or both. The data and control parts of the message are placed into separate 
buffers, as described below. The semantics of each part is defined by the 
STREAMS module that generated the message. 


fd specifies a file descriptor referencing an open stream. ctlptr and dataptr 
each point to a strbuf structure which contains the following members: 


int maxlen; /* maximum buffer length */ 
int len; /* length of data = */ 
char “buf; /* ptrto buffer */ 


where buf points to a buffer in which the data or control information is to be 
placed, and maxlen indicates the maximum number of bytes this buffer can 
hold. On return, /en contains the number of bytes of data or control information 
actually received, or is 0 if there is a zero-length control or data part, or is -1 if 
no data or control information is present in the message. Flags may be set to 
the values 0 or RS_HIPRI and is used as described below. 


ctlptr is used to hold the control part from the message and datapir is used to 
hold the data part from the message. If ctlptr (or dataptr) is NULL or the 
maxlen field is -1, the control (or data) part of the message is not processed and 
is left on the stream head read queue and len is set to -1. If the maxlen field is 
set to 0 and there is a zero-length control (or data) part, that zero-length part is 
removed from the read queue and /en is set to 0. If the maxlen field is set to 0 
and there are more than zero bytes of control (or data) information, that 
information is left on the read queue and /en is set to 0. If the maxlen field in 
ctlptr or dataptr is less than, respectively, the control or data part of the 
message, maxlen bytes are retrieved. In this case, the remainder of the message 
is left on the stream head read queue and a non-zero return value is provided, as 
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described below under DIAGNOSTICS. If information is retrieved from a 
priority message, flags is set to RS_HIPRI on return. 


By default, getmsg processes the first priority or non-priority message available 
on the stream head read queue. However, a user may choose to retrieve only 
priority messages by setting flags to RS_HIPRI. In this case, getmsg will only 
process the next message if it is a priority message. 


If O_NDELAY has not been set, getmsg blocks until a message, of the type(s) 
specified by flags (priority or either), is available on the stream head read 
queue. If O_NDELAY has been set and a message of the specified type(s) 1s not 
present on the read queue, getmsg fails and sets errno to EAGAIN. 


If a hangup occurs on the stream from which messages are to be retrieved, 
getmsg will continue to operate normally, as described above, until the stream 
head read queue is empty. Thereafter, it will return 0 in the len fields of ctlptr 
and dataptr. 


getmsg fails if one or more of the following are true: 


[EAGAIN] The O_NDELAY flag is set, and no messages are available. 

[EBADF] fd is not a valid file descriptor open for reading. 

[EBADMSG] Queued message to be read is not valid for getmsg. 

[EFAULT] ctlptr, dataptr, or flags points to a location outside the 
allocated address space. 

[EINTR] A signal was caught during the getmsg system call. 

[EINVAL] An illegal value was specified in flags, or the stream 
referenced by fd is linked under a multiplexor. 

[ENOSTR] A stream is not associated with fd. 


A getmsg can also fail if a STREAMS error message had been received at the 
stream head before the call to getmsg. The error returned is the value contained 
in the STREAMS error message. 


SEE ALSO 
intro(2), read(2), poll(2), putmsg(2), write(2). 
UNIX System V Release 3.2 Streams Primer. 
UNIX System V Release 3.2 Streams Programmer’ s Guide. 
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DIAGNOSTICS 
Upon successful completion, a non-negative value is returned. A value of 0 
indicates that a full message was read successfully. A return value of 
MORECTL indicates that more control information is waiting for retrieval. A 
return value of MOREDATA indicates that more data is waiting for retrieval. A 
return value of MORECTLIMOREDATA indicates that both types of information 
remain. Subsequent getmsg calls will retrieve the remainder of the message. 
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NAME 
getpeername - get name of connected peer 

SYNOPSIS 
int getpeername(s, name, namelen) 
int s; 
Struct sockaddr *name; 
int *namelen; 

DESCRIPTION 
The getpeername call returns the name of the peer connected to socket s. The 
namelen parameter should be initialized to indicate the amount of space pointed 
to by name. On retum it contains the actual size of the name returned (in 
bytes). The interpretation of name depends on the ‘‘communication domain’’ 
[see protocols(4)]. 

SEE ALSO 
bind(2), getsockname(2), intro(2), socket(2), intro(7). 
CTIX Network Programmer’ s Primer. 

DIAGNOSTICS 
A 0 is returned if the call succeeds, -1 if it fails. 


ERRORS 
The call succeeds unless one of the following is true: 


[EBADF] The argument s is not a valid descriptor. 
[ENOTSOCK] The argument s is a file, not a socket. 
[ENOTCONN] _ The socket is not connected. 


[ENOBUFS] Insufficient resources were available in the system to 
perform the operation. 
{[EFAULT] The name parameter points to memory not in a valid part of 


the process address space. 
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NAME 
getpid, getpgrp. getppid - get process, process group, and parent process IDs 


SYNOPSIS 
int getpid () 
int getpgrp () 
int getppid () 


DESCRIPTION 
The getpid call returns the process ID of the calling process. 


The getpgrp call returns the process group ID of the calling process. 
The getppid call returns the parent process ID of the calling process. 


SEE ALSO 
exec(2), fork(2), intro(2), setpgrp(2), signal(2). 
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NAME 
getsockname - get socket name 


SYNOPSIS 
int getsockname(s, name, namelen) 
int s; 
Struct sockaddr *name; 
int *namelen; 


DESCRIPTION 
The getsockname call returns the current name for the specified socket (s). The 
namelen parameter should be initialized to indicate the amount of space pointed 
to by name. On return namelen contains the actual size of the name returned 
(in bytes). 


SEE ALSO 
bind(2), intro(2), socket(2), intro(7). 
CTIX Network Programmer’ s Primer. 


RETURN VALUE 
A Ois returned if the call succeeds, -1 if it fails. 
ERRORS 
The call succeeds unless: 
[EBADF] The argument s is not a valid descriptor. 
[ENOTSOCK] The argument s is a file, not a socket. 
[ENOBUFS] Insufficient resources were available in the system to 


perform the operation. 


[EFAULT] The name parameter points to memory not in a valid part of 
the process address space. 


en 


GETSOCKOPT(2) (CTIX Internetworking ) GETSOCKOPT (2) 


NAME 
getsockopt, setsockopt - get and set options on sockets 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


int getsockopt(s, level, optname, optval, optlen) 
int s, level, optname; 

char *optval; 

int *optlen; 


int setsockopt(s, level, optname, optval, optlen) 
int s, level, optname; 

char *optval; 

int optien; 


DESCRIPTION 
The getsockopt and setsockopt calls manipulate options associated with a 
socket. Options can exist at multiple protocol levels; they are always present at 
the uppermost ‘‘socket’’ level. 


When manipulating socket options the level at which the option resides and the 
name of the option must be specified. To manipulate options at the ‘‘socket’’ 
level, level is specified as SOL_SOCKET. To manipulate options at any other 
level the protocol number of the appropriate protocol controlling the option is 
supplied. For example, to indicate that an option is to be interpreted by the TCP 
protocol, level should be set to the protocol number of TCP; see getprotoent (3). 


The parameters optval and optlen are used to access option values for 
setsockopt. For getsockopt they identify a buffer in which the value for the 
requested option(s) are to be returned. For getsockopt, optlen is a value-result 
parameter, initially containing the size of the buffer pointed to by optval, and 
modified on return to indicate the actual size of the value returned. If no option 
value is to be supplied or returned, optval may be supplied as 0. 


optname and any specified options are passed uninterpreted to the appropriate 
protocol module for interpretation. The include file <sys/socket.h> contains 
definitions for “‘socket’’ level options, described below. Options at other 
protocol levels vary in format and name; consult the appropriate entries in 
section (4). 


Most socket-level options take an int parameter for optval. For setsockopt, the 
parameter should be non-zero to enable a boolean option, or zero if the option is 
to be disabled. SO_LINGER uses a struct linger parameter, defined in 
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<sys/socket.h>, which specifies the desired state of the option and the linger 
interval (see below). 


The following options are recognized at the socket level. Except as noted, each 


may be examined with getsockopt and set with setsockopt. 


SO_DEBUG 
SO_REUSEADDR 
SO_KEEPALIVE 
SO_DONTROUTE 
SO_LINGER 
SO_BROADCAST 
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SO_SNDBUF 
SO_RCVBUF 
SO_TYPE 
SO_ERROR 


Toggle recording of debugging information. 
Toggle on/off local address reuse. 

Toggle keep connections alive. 

Toggle routing bypass for outgoing messages. 
Linger on close if data present. 


Toggle permission to transmit broadcast messages. 


Toggle recention of out-of-band data in band, 
Set buffer size for output. 

Set buffer size for input. 

Get the type of the socket (get only). 


Get and clear error on the socket (get only). 


SO_DEBUG enables debugging in the underlying protocol modules. 


SO_REUSEADDR indicates that the rules used in validating addresses supplied 
in a bind(2) call should allow reuse of local addresses. 


SO_KEEPALIVE enables the periodic transmission of messages on a connected 
socket. Should the connected party fail to respond to these messages, the 
connection is considered broken and processes using the socket are notified via 
a SIGPIPE signal. 


SO_DONTROUTE indicates that outgoing messages should bypass the standard 
routing facilities. Instead, messages are directed to the appropriate network 
interface according to the network portion of the destination address. 


SO_LINGER controls the action taken when unsent messags are queued on 
socket and a close(2) is performed. If the socket promises reliable delivery of 
data and SO_LINGER is set, the system blocks the process on the close attempt 
until it is able to transmit the data or until it decides it is unable to deliver the 
information (a timeout period, termed the linger interval, is specified in the 
setsockopt call when SO_LINGER is requested). If SO_LLINGER is disabled and a 
close is issued, the system processes the close in a manner that allows the 
process to continue as quickly as possible. 
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SO_BROADCAST requests permission to send broadcast datagrams on the 
socket. Broadcast was a privileged operation in earlier versions of the system. 


With protocols that support out-of-band data, SO_LOOBINLINE requests that 
out-of-band data be placed in the normal data input queue as received; it is then 
accessible with recy or read calls without the MSG_OOB flag. 


SO_SNDBUF and SO_RCVBUF are options to adjust the normal buffer sizes 
allocated for output and input buffers, respectively. The buffer size may be 
increased for high-volume connections, or may be decreased to limit the 
possible backlog of incoming data. The system places an absolute limit on 
these values. 


SO_TYPE and SO_ERROR are options used only with setsockopt. SO_TYPE 
returns the type of the socket, such as SOCK_STREAM;; it is useful for servers 
that inherit sockets on startup, SO_ERROR returns any nending error on the 


socket and clears the error status. It may be used to check for asynchronous 
errors on connected datagram sockets or for other asynchronous errors. 


SEE ALSO 


ioctl(2), socket(2), getprotoent(3). 
CTIX Network Programmer's Primer. 


RETURN VALUE 


ERRORS 


BUGS 


A 0 is returned if the call succeeds, -1 if it fails. 

The call succeeds unless: 

{EBADF] The argument s is not a valid descriptor. 

[ENOTSOCK] The argument s is a file, not a socket. 

[ENOPROTOOPT} The option is unknown at ihe level indicated. 

[EFAULT] The address pointed to by optval is not in a valid part 


of the process address space. For getsockopt, this error 
may also be returned if optien is not in a valid part of 
the process address space. 


Several of the socket options should be handled at lower levels of the system. 
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NAME 
getumeofday, settimeofday - get/set date and time 


SYNOPSIS 
#include <sys/time.h> 


int gettimeofday(tp, tzp) 
struct timeval *tp; 
struct timezone *tzp; 


int settimeofday(tp, tzp) 
struct timeval *tp; 
struct timezone *tzp; 


DESCRIPTION 
The system’s notion of the current Greenwich time and the current time zone is 


. 
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obiaificd with tic géitimeofday Call, and set with ihe seiiimeofday cali. The 
time is expressed in seconds and microseconds since midnight (0 hour), January 
1, 1970. The resolution of the system clock is hardware dependent, and the 
time may be updated continuously or in ‘‘ticks.’’ If tzp is zero, the time zone 


information will not be returned or set. 
The structures pointed to by tp and tzp are defined in <sys/time.h> as: 


struct timevail { 
long tv_sec; /* seconds since Jan. 1, 1970 */ 
long tv_usec; /* and microseconds */ 


}; 


struct timezone { 
int tz_minuteswest; /* of Greenwich */ 
int tz_dsttime; /* type of dst correction to apply */ 
iB 
The timezone structure indicates the local time zone (measured in minutes of 
time westward from Greenwich), and a flag that, if nonzero, indicates that 
Daylight Savings Time applies locally during the appropriate part of the year. 


Only the super-user can set the time of day or time zone. 
SEE ALSO 
date(1), adjtime(2), cume(3C). 


RETURN VALUE 
A 0 return value indicates that the call succeeded. A -1 return value indicates 
an error occurred, and in this case an error code is stored into the global 
variable errno. 
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ERRORS 
The following error codes may be set in errno: 
[EFAULT] An argument address referenced invalid memory. 
[EPERM] A user other than the super-user attempted to set the time. 
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NAME 


getuid, geteuid, getgid, getegid - get real user, effective user, real group, and 


effective group IDs 


SYNOPSIS 
unsigned short getuid () 


unsigned short geteuid () 
unsigned short getgid () 
unsigned short getegid () 


DESCRIPTION 
getuid returns the real user ID of the calling process. 


geteuid returns the effective user ID of the calling process. 
getgid returns the real group ID of the calling process. 
getegid returns the effective group ID of the calling process. 


SEE ALSO 
intro(2), setuid(2). 


GETUID(2) 
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NAME 
ioctl - control device 


SYNOPSIS 
int ioctl (fildes, request, arg) 
int fildes, request; 


DESCRIPTION 
The ioctl call performs a variety of control functions on devices and STREAMS. 
For non-STREAMS files, the functions performed by this call are device-specific 
control functions. The arguments request and arg are passed to the file 
designated by fildes and are interpreted by the device driver. This control is 
infrequently used on non-STREAMS devices, with the basic input/output 
functions performed through the read(2) and write(2) system calls. 


ror STREAMS files, specific functions are performed by the ioctl call as 
described in streamio(7). 


The fildes argument is an open file descriptor that refers to a device; request 
selects the control function to be performed and depends on the device being 
addressed; arg represents additional information needed by this specific device 
to perform the requested function. The data type of arg depends upon the 
particular control request, but it is either an integer or a pointer to a device- 
specific data structure. 


In addition to device-specific and STREAMS functions, generic functions are 
provided by more than one device driver, for example, the general terminal 
interface [see termio(7)]. 


The ioctl call fails for any type of file if one or more of the following are true: 
[EBADF] fildes is not a valid open file descriptor. 


[ENOTTY] fildes is not associated with a device driver that accepts 
control functions. 


[EINTR] A signal was caught during the ioctl system call. 


The ioctl call also fails if the device driver detects an error; the error is passed 
through ioctl without change to the caller. A particular driver might not have 
all of the following error cases. Other requests to device drivers fail if one or 
more of the following are true: 


[EFAULT] Request requires a data transfer to or from a buffer pointed to 
by arg, but some part of the buffer is outside the process’s 
allocated space. 
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[EINVAL] Request or arg is not valid for this device. 

[EIO} Some physical I/O error has occurred. 

[ENXIO] The request and arg are valid for this device driver, but the 
service requested can not be performed on this particular 
subdevice. 

[ENOLINK] fildes is on a remote machine and the link to that machine is 


no longer active. 
STREAMS errors are described in streamio(7). 
SEE ALSO 
streamio(7), termio(7). 
DIAGNOSTICS 
Upon successful completion, the value returned depends upon the device 
control function, but must be a non-negative integer. Otherwise, a value of -1 is 
retumed and errno is set to indicate the error. 
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NAME 
kill - send a signal to a process or a group of processes 


SYNOPSIS 
int kill (pid, sig) 
int pid, sig; 

DESCRIPTION 
kill sends a signal to a process or a group of processes. The process or group of 
processes to which the signal is to be sent is specified by pid. The signal that is 
to be sent is specified by sig and is either one from the list given in signal (2), or 
O. If stg is O (the null signal), error checking is performed but no signal is 
actually sent. This can be used to check the validity of pid. 


The real or effective user ID of the sending process must match the real or 
effective user ID of the receiving process, unless the effective user ID of ihe 
sending process is super-user. 


The processes with a process ID of 0 and a process ID of 1 are special processes 
{see intro(2)] and will be referred to below as procO and proc! , respectively. 


If pid is greater than zero, sig will be sent to the process whose process ID is 
equal to pid. pid may equal 1. 

If pid is 0, sig will be sent to all processes excluding proc0 and proc! whose 
process group ID is equal to the process group ID of the sender. 


If pid is -1 and the effective user ID of the sender is not super-user, sig will be 
sent to all processes excluding proc0 and proc! whose real user ID is equal to 
the effective user ID of the sender. 


If pid is -1 and the effective user ID of the sender is super-user, sig will be sent 
to all processes excluding procO and proc!. 


If pid is negative but not -1, sig will be sent to all processes whose process 
group ID is equal to the absolute value of pid. 


kill will fail and no signal will be sent if one or more of the following are true: 


[EINVAL] sig iS not a valid signal number. 

[EINVAL] sig is SIGKILL and pid is 1 (procl). 

[ESRCH] No process can be found corresponding to that specified by 
pid. 

[EPERM] The user ID of the sending process is not super-user, and its 


real or effective user ID does not match the real or effective 
user ID of the receiving process. 
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SEE ALSO 
kill(1), getpid(2), setpgrp(2), signal(2), sigset(2). 

DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


link - link to a file 


SYNOPSIS 


LINK(2) 


int link (path1, path2) 
char *pathl, *path2; 


DESCRIPTION 


The path] argument points to a path name naming an existing file; path2 points 
to a path name naming the new directory entry to be created. 


The link call creates a new link (directory entry) for the existing file. It fails 
and no link is created if one or more of the following are true: 


[ENOTDIR] 


[ENOENT] 
[EACCES] 


[ENOENT] 
[EEXIST] 
[EPERM] 


[EXDEV] 


[ENOENT] 
[EACCES] 


[EROFS] 


[EFAULT] 


[EMLINK] 
[EINTR} 
[ENOLINK] 


[EMULTIHOP] 


SEE ALSO 
unlink(2). 


A component of either path prefix is not a directory. 

A component of either path prefix does not exist. 

A component of either path prefix denies search permission. 
The file named by path does not exist. 

The link named by path2 exists. 


The file named by path! is a directory and the effective user 
ID is not super- user. 


The link named by path2 and the file named by path] are on 
different logical devices (file systems). 


path2 points to a null path name. 


The requested link requires writing in a directory with a 
mode that denies write permission. 


The requested link requires writing in a directory on a read- 
only file system. 


path points outside the allocated address space of the 
process. 


The maximum number of links to a file would be exceeded. 
A signal was caught during the link system call. 


path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 


— 
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DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 
listen - listen for connections on a socket 


SYNOPSIS 
int listen (s, backlog) 
int s, backlog; 


DESCRIPTION 
To accept connections, a socket is first created with socket(2), a backlog for 
incoming connections is specified with listen, and then the connections are 
accepted with accept(2). The listen call applies only to sockets of type 
SOCK_STREAM. 


The backlog parameter defines the maximum length to which the queue of 
pending connections may grow. If a connection request arrives with the queue 
full the client will receive an error wiih an indication of ECONNREFUSED. 

SEE ALSO 
accept(2), connect(2), socket(2). 
CTIX Network Programmer's Primer. 


RETURN VALUE 
A 0 return value indicates success; -1 indicates an error. 
ERRORS 
The call fails if: 
(EBADF] The argument s is not a valid descriptor. 
[ENOTSOCK] The argument s is not a socket. 
[EOPNOTSUPP] The socket is not of a type that supports the operation 
listen. 
BUGS 


The backlog is currently limited (silently) to 5. 
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NAME 


locking - exclusive access to regions of a file 


SYNOPSIS 


int locking (filedes, mode, size); 
int fildes, mode; 
long size; 


DESCRIPTION 


The locking call places or removes a kernel-enforced lock on a region of a file. 
The calling process has exclusive access to regions it has locked. If another 
process uses read(2), write (2), creat(2), or open(2) (with O_TRUNC ) in a way 
that reads or modifies part of the locked region, the second process’s system call 
does not return until the lock is released, unless deadlock or some other error is 
detected. A process whose execution is suspended in such a manner is said to 
be blocked . 


Parameters specify the file to be locked or unlocked, the kind of lock or unlock, 
and the region affected: 


filedes Specifies the file to be locked or unlocked; filedes is a file descriptor 
returned by an open, create, pipe, fcntl, or dup system call. 


mode Specifies the action: 0 for lock removal; 1 for blocking lock; 2 for 
checking lock. Blocking and checking locks differ only if the 
attempted lock is itself locked out: a blocking lock waits until the 
existing lock or locks are removed; a checking lock immediately 
returns an error. 


size The region affected begins at the current file offset associated with 
filedes and is size bytes long. If size is zero, the region affected ends 
at the end of the file. 


Locking imposes no structure on a CTIX file. A process can arbitrarily lock any 
unlocked byte and unlock any locked byte. However, creating a large number 
of noncontiguous locked regions can fill up the system’s lock table and make 
further locks impossible. It is advisable that a program’s use of locking segment 
the file in the same way as does the program’s use of read and write. 


A process is said to be deadlocked if it is sleeping until an unlocking which is 
indirectly prevented by that same sleeping process. The kernel will not permit a 
read, write, creat, open with O TRUNC, or blocking locking if such a call 
would deadlock the calling process. Errno is set to EDEADLOCK. The 
standard response to such a situation is for the program to release all its existing 
locked areas and try again. If a locking call fails because the kernel’s table of 
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locked areas is full, again, errno is set to EDEADLOCK and, again, the calling 
program should release its existing locked areas. 


Special files and pipes can be locked, but no input/output is blocked. 


Locks are automatically removed if the process that placed the lock terminates 
or closes the file descriptor used to place the lock. 


SEE ALSO 
create(2), close(2), dup(2), open(2), read(2), write(2). 


RETURN VALUE 
A return value of -/ indicates an error, with the error value in errno. 


[EACCES] A checking lock on a region already locked. 


[EDEADLOCK] A lock that would cause deadlock or overflow the system’s 
lack tahle 
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WARNING 
Do not apply any standard input/output library function to a locked file: this 
library does not know about locking. 


Two forms of file locking are available: locking (2) and fentl(2). locking (2) is 
retained for compatibility with previous versions of CTIX. Although both forms 
are compatible and interchangeable, new programs should use only fcn#l (2) for 
record locking. Note that the error return values differ. 
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NAME 
Iseek - move read/write file pointer 


SYNOPSIS 
long Iseek (fildes, offset, whence) 
int fildes; 
long offset; 
int whence; 


DESCRIPTION 
fildes is a file descriptor returned from a creat, open, dup, or fcntl system call. 
lseek sets the file pointer associated with fildes as follows: 


@ If whence is O, the pointer is set to offset bytes. 
e If whence is 1, the pointer ts set to its current location plus offset. 
e If whence is 2, the pointer is set to the size of the file plus offset. 


Upon successful completion, the resulting pointer location, as measured in 
bytes from the beginning of the file, is returned. Note that if fildes is a remote 
file descriptor and offset is negative, /seek will return the file pointer even if it 
is negative. 


Iseek will fail and the file pointer will remain unchanged if one or more of the 
following are true: 


[EBADF] fildes is not an open file descriptor. 
[ESPIPE] fildes is associated with a pipe or fifo. 
[EINVAL and SIGSYS signal] 


whence is not 0, 1, or 2. 
[EINVAL] fildes is noi a remote file descriptor, and the resulting file 
pointer would be negative. 


Some devices are incapable of seeking. The value of the file pointer associated 
with such a device is undefined. 


SEE ALSO 
creat(2), dup(2), fentl(2), open(2). 


DIAGNOSTICS 
Upon successful completion, a non-negative integer indicating the file pointer 
value is returned. Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 
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NAME 


MKDIR (2) 


mkdir - make a directory 


SYNOPSIS 


int mkdir (path, mode) 


char *path; 
int mode; 


DESCRIPTION 


The mkdir call creates a new directory with the name path. The mode of the 
new directory is initialized from the mode. The protection part of the mode 
argument is modified by the process’s mode mask [see umask (2)]. 


The directory’s owner ID is set to the process’s effective user ID. The 
directory’s group ID is set to the process’s effective group ID. The newly 
Created directory is empty with the possible exception of entries for the ‘‘dot’’ 
(.) and ““dot dot’ (..) directories. The mkdir call fails and no directory is 
created if one or more of the following are true: 


{[ENOTDIR] 


[ENOENT] 
[ENOLINK] 


[EMULTIHOP] 


[EACCES] 


[ENOENT] 


[EEXIST] 


[EROFS] 
[EFAULT] 


[EMLINK} 


(EIO] 
DIAGNOSTICS 


A component of the path prefix is not a directory. 
A component of the path prefix does not exist. 


Path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 


Either a component of the path prefix denies search 
permission or write permission is denied on the parent 
directory of the directory to be created. 


The path is longer than the maximum allowed. 
The named file already exists. 
The path prefix resides on a read-only file system. 


Path points outside the allocated address space of the 
process. 


The maximum number of links to the parent directory would 
be exceeded. 


An J//O error has occurred while accessing the file system. 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned, and errno is set to indicate the error. 
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NAME 
mknod - make a directory, or a special or ordinary file 


SYNOPSIS 
int mknod (path, mode, dev) 
char *path; 
int mode, dev; 


DESCRIPTION 
The mknod call creates a new file named by the path name pointed to by path. 
The mode of the new file is initialized from mode, where the value of mode is 
interpreted as follows: 


0170000 file type; one of the following: 


0010000 fifo special 

0020000 character special 
0040000 directory 

0060000 block special 

0100000 or 0000000 ordinary file 


0004000 set user ID on execution 
00020#0 set group ID on execution if # is 7, 5,3, or 1 
enable mandatory file/record locking if # is 6, 4, 2, or 0 
0001000 = save text image after execution 
0000777 = access permissions; constructed from the following: 


0000400 ~=read by owner 

0000200 = write by owner 

0000100 = execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
Q000007 ‘read, write, execute (search) by others 


The owner ID of the file is set to the effective user ID of the process. The group 
ID of the file 1s set to the effective group ID of the process. 


Values of mode other than those above are undefined and should not be used. 
The low-order 9 bits of mode are modified by the process’s file mode creation 
mask: all bits set in the process’s file mode creation mask are cleared [see 
umask(2)]. If mode indicates a block or character special file, dev is a 
configuration-dependent specification of a character or block I/O device. If 
mode does not indicate a block special or character special device, dev is 
ignored. 
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The mknod call can be invoked only by the super-user for file types other than 


FIFO special. 


The call fails and the new file is not created if one or more of the following are 


true: 
[EPERM} 
[ENOTDIR] 
[ENOENT] 
{[EROFS] 


[ENOSPC] 
[EINTR] 
[ENOLINK] 


[EMULTIHOP] 


SEE ALSO 


The effective user ID of the process is not super-user. 
A component of the path prefix is not a directory. 
A component of the path prefix does not exist. 


The directory in which the file is to be created is located on a 
read-only file system. 
The named file exists. 
Path points outside tl 


process. 
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No space is available. 
A signal was caught during the mknod system call. 


Path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 


mkdir(1), chmod(2), exec(2), umask(2), fs(4). 


DIAGNOSTICS 


Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 


WARNING 


If mknod is used to create a device in a remote directory, the major and minor 
device numbers are interpreted by the server. 
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NAME 


mount - mount a file system 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/mount.h> 


int mount (spec, dir, mflag, fstyp, dataptr, datalen) 
char *spec, *dir; 

int mflag, fstyp; 

char *dataptr; 

int datalen; 


DESCRIPTION 


mount requests that a removable file system contained on the block special file 
identified by spec be mounted on the directory identified by dir. Spec and dir 
are pointers to path names. fstyp is the file system type number. The sysfs(2) 
system call can be used to determine the file system type number. Note that if 
both the MS_DATA and MS_FSS flag bits of mflag are off, the file system type 
will default to the root file system type. Only if either flag is on will fstyp be 
used to indicate the file system type. 


If the MS_DATA flag is set in mflag the system expects the datapir and datalen 
arguments to be present. Together they describe a block of file-system specific 
data at address dataptr of length datalen. This is interpreted by file-system 
specific code within the operating system and its format depends upon the file 
system type. A particular file system type may not require this data, in which 
case dataptr and datalen should both be zero. Note that MS_FSS is obsolete and 
will be ignored if MS_DATA is also set, but if MS_FSS is set and MS_DATA is 
not, dataptr and datalen are both assumed to be zero. 


Upon successful completion, references to the file dir will refer to the root 
directory on the mounted file system. 


The low-order bit of mflag is used to control write permission on the mounted 
file system; if 1, writing is forbidden, otherwise writing is permitted according 
to individual file accessibility. 


mount may be invoked only by the super-user. It is intended for use only by the 
mount(1M) utility. 


mount will fail if one or more of the following are true: 
[EPERM] The effective user ID is not super-user. 
[ENOENT] Any of the named files does not exist. 
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[ENOTDIR] 
[EREMOTE]} 
[ENOLINK] 


[EMULTIHOP] 


[ENOTBLK] 
[ENXIO] 
[ENOTDIR] 
[EFAULT] 


[EBUS Y] 


[EBUS Y] 
[EBUSY] 
[EROFS] 
[ENOSPC] 


[EINVAL] 


[EBADFS} 


SEE ALSO 
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A component of a path prefix is not a directory. 
Spec is remote and cannot be mounted. 


Path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 

Spec is not a block special device. 

The device associated with spec does not exist. 

Dir is not a directory. 


Spec or dir points outside the allocated address space of the 
process. 


Dir is currently mounted on, is someone’s current working 
directory, or is otherwise busy. 


The device associated with spec is currently mounted. 
There are no more mount table entries. 
Spec is write protected and mflag requests write permission. 


The file system state in the super-block is not FSOKAY and 
mflag requests write permission. 

The super block has an invalid magic number or the fstyp is 
invalid or mflag is not valid. 


An attempt to mount a bit-mapped file system failed due to 
the dirty flag being set for that file system. 


mount(1M), sysfs(2), umount(2), fs(4). 


DIAGNOSTICS 


Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 
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NAME 


MSGCTL(2) 


msgctl - message control operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 


int msgctl (msqid, cmd, buf) 


int msgid, cmd; 


struct msqid_ ds *buf; 


DESCRIPTION 


The msgcil call provides a variety of message control operations as specified by 
cmd. The following cmds are available: 


irc STAT 


IPC_SET 


IPC_RMID 


Piace the current value of each member of the data structure 
associated with msqid into the structure pointed to by buf. 
The contents of this structure are defined in intro(2). 
{READ} 


Set the value of the following members of the data structure 
associated with msqid to the corresponding value found in 
the structure pointed to by buf: 


msg_perm.uid 

msg_perm.gid 

msg_perm.mode /* only low 9 bits «/ 
msg qbytes 


This cmd can be executed only by a process that has an 
effective user ID equal to either that of super-user, or to the 
value of msg perm.cuid or msg perm.uid in the data 
Structure associated with msgid. Only super-user can raise 
the value of msg_qbytes. 


Remove the message queue identifier specified by msgid 
from the system and destroy the message queue and data 
structure associated with it. This cmd can be executed only 
by a process that has an effective user ID equal to either that 
of super-user, or to the value of msg perm.cuid or 
msg_perm.uid in the data structure associated with msqid. 
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NAME 
msgget - get message queue 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 


int msgget (key, msgfig) 
key t key; 
int msgflg; 
DESCRIPTION 
The msgget call returns the message queue identifier associated with key. 


A message queue identifier and associated message queue and data structure 
[see intro(2)| are created for key if one of the following are true: 


e Key is equal to IPC_PRIVATE. 


® Key does not already have a message queue identifier associated with 
it, and (msgflg & IPC_CREAT) is “‘true’’. 
Upon creation, the data structure associated with the new message queue 
identifier is initialized as follows: 


° Msg perm.cuid, msg_perm.uid, msg_perm.gid, and msg_perm.cgid 
are set equal to the effective user ID and effective group ID, 
respectively, of the calling process. 


e The low-order 9 bits of msg_perm.mode are set equal to the low- 
order 9 bits of msgflg. 

e Msg_qnum, msg Ispid, msg Irpid, msg stime, and msg rtime are 
set equal to 0. 

® Msg ctime is set equal to the current time. 

® Msg _qbytes is set equal to the system limit. 


The msgget call fails if one or more of the following are true: 


[EACCES] A message queue identifier exists for key, but operation 
permission [see intro(2)] as specified by the low-order 9 bits 
of msgflg would not be granted. 

[ENOENT] A message queue identifier does not exist for key and 


(msgflg & IPC_CREAT) ts ‘‘false’’. 
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[ENOSPC] A message queue identifier is to be created but the system- 
imposed limit on the maximum number of allowed message 
queue identifiers system wide would be exceeded. 


[EEXIST] A message queue identifier exists for key but [(msgflg & 
IPC_CREAT) & (msgflg & IPC_EXCL)] is ‘‘true’’. 


SEE ALSO 
intro(2), msgctl(2), msgop(2). 


DIAGNOSTICS 
Upon successful completion, a non-negative integer, namely a message queue 
identifier, is returned. Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 
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NAME 
msgop - message operations 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 


int msgsnd (msqid, msgp, msgsz, msgflg) 
int msqid; 

struct msgbuf *msgp; 

int msgsz, msgflg; 


int msgrcv (msqid, msgp, msgsz, msgtyp, msgflg) 
int msgid; 


struct msgbuf +msgp; 


int msgsz; 
long msgtyp; 
int msgflg; 

DESCRIPTION 
The msgsnd call is used to send a message to the queue associated with the 
message queue identifier specified by msqid. {WRITE} msgp points to a 
structure containing the message. This structure 1s composed of the following 
members: 


long mtype; /* message type */ 
char mitext{j; /* message text +/ 
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The mtype member is a positive integer that can be used by the receiving 
process for message selection (see msgrcy below). The mtext member is any 
text of length msgsz bytes; msgsz can range from 0 to a system-imposed 
maximum. 


The msgflg parameter specifies the action to be taken if one or more of the 
following are true: 


e The number of bytes already on the queue is equal to msg_qbytes [see 
intro(2)). 


e The total number of messages on all queues system-wide is equal to 
the system-imposed limit. 
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These actions are as follows: 


® If (msgflg & IPC_NOWAIT) is ‘‘true’’, the message is not sent and the 
calling process returns immediately. 


® If (msgflg & IPC_NOWAIT) is “‘false’’, the calling process suspends 
execution until one of the following occurs: 


- The condition responsibie for the suspension no ionger exists, 
in which case the message is sent. 


- msqid is removed from the system [see msgctl(2)]. When this 
occurs, errno is set equal to EIDRM, and a value of -1 is 
returned. 


- The calling process receives a signal that is to be caught. In 
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resumes execution in the manner prescribed in signal (2). 
The msgsnd call fails and no message is sent 1f one or more of the following are 


true: 


[EINVAL] msqid is not a valid message queue identifier. 

[EACCES] Operation permission is denied to the calling process [see 
intro (2)]. 

[EINVAL] mtype 1s less than 1. 

[EAGAIN] The message cannot be sent for one of the reasons cited 
above and (msgflg & IPC_NOWAIT) is ‘‘true’’. 

[EINVAL] msgsz is less than zero or greater than the system-imposed 
limit. 

{EFAULT] msgp points to an illegal address. 


Upon successful completion, the following actions are taken with respect to the 
data structure associated with msqid [see intro (2)]. 


¢ msg qnum is incremented by 1. 
e msg _Ispid is set equal to the process ID of the calling process. 
e¢ msg stime is set equal to the current time. 


msgrcv reads a message from the queue associated with the message queue 
identfier specified by msgid and places it in the structure pointed to by msgp. 
{READ} This structure is composed of the following members: 


long mtype; /* message type */ 
char mtext{j; /*« message text */ 


Oe 
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mtype is the received message’s type as specified by the sending process. mtext 
is the text of the message. msgsz specifies the size in bytes of mtext. The 
received message is truncated to msgsz bytes if it is larger than msgsz and 
(msgefig & MSG_NOERROR) is “‘true’’. The truncated part of the message is 
lost and no indication of the truncation is given to the calling process. 


msgtyp specifies the type of message requested as follows: 
e If msgtyp is equal to 0, the first message on the queue is received. 
e If msgtyp is greater than 0, the first message of type msgtyp is received. 


@ If msgtyp is less than 0, the first message of the lowest type that is less 
than or equal to the absolute value of msgtyp is received. 


msgflg specifies the action to be taken if a message of the desired type is not on 


the anene. These are as follows: 
@ If (msgflg & IPC_NOWAIT) is ‘“‘true’’, the calling process returns 
immediately with a return value of -1 and errno set to ENOMSG. 


e If (msgflg & IPC_NOWAIT) is ‘‘false’’, the calling process suspends 
execution until one of the following occurs: 


- A message of the desired type is placed on the queue. 


- msqid is removed from the system. When this occurs, errno is 
set equal to EIDRM, and a value of -1 is returned. 


- The calling process receives a signal that is to be caught. In 
this case a message is not received and the calling process 
resumes execution in the manner prescribed in signal (2). 


The msgrcyv call fails and no message is received if one or more of the following 
are true: 


[EINVAL] msgid is not a valid message queue identifier. 

[EACCES] Operation permission is denied to the calling process. 

[EINVAL] msgsz is less than 0. 

[E2BIG] mtext is greater than msgsz and (msgflg & MSG_NOERROR) 
is ‘‘false’’. 

[ENOMSG] The queue does not contain a message of the desired type 
and (msgtyp & IPC_NOWAIT) is ‘‘true’’. 

[EFAULT] msgp points to an illegal address. 


Upon successful completion, the following actions are taken with respect to the 
data structure associated with msgid [see intro(2)}. 
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6 msg qnum is decremented by 1. 
e msg Irpid is set equal to the process ID of the calling process. 
® msg _rtime is set equal to the current time. 
SEE ALSO 
intro(2), msgctl(2), msgget(2), signal(2). 
DIAGNOSTICS 


If msgsnd or msgrcv return due to the receipt of a signal, a value of -1 is 
returned to the calling process and errno is set to EINTR. If they return due to 
removal of msqid from the system, a value of -1 is returned and errno is set to 
EIDRM. 


Upon successful completion, the return value is as follows: 
e msegsnd returns a value of 0. 


e msgrcy returns a value equal to the number of bytes actually placed 
into mtext. 


Otherwise, a value of - 1 is returned and errno is set to indicate the error. 
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NAME 
nfssys - common shared NFS system calls 


SYNOPSIS 
#include <sys/fs/nfs.h> 


int nfssys(cmd, argp) 
int cmd; 
char *argp; 


nfs_getfh(fd, fhp) 
int fd; 
char *fhp; 
Struct { 
int fdes; 
char *fhp; 
} args; 
extern int nfssys(); 


args.fdes = fd; 

args.fhp = fhp; 

return(nfssys(2, &args)); 
} 


nfs_svc(fd) 
int fd; 
{ 
extern int nfssys (); 
return(nfssys(1, fd); 
} 


async_daemon() 


extern int nfssys(); 
return(nfssys(3, 0)); 
} 


DESCRIPTION 
The nfssys system call is provided to allow NFS daemons [through nfs_geifh(), 
nfs_svc(), and async_daemon() routines] to enter the kernel. Note that this call 
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is not intended for general purpose use, and is described here only for 
illustration. 


The cmd argument to nfssys specifies the NFS routine to use: 
1 is nfs_svc() 

2 is nfs_getfh() 

3 is async_daemon(). 

The argp argument is the error return. 


The nfs_getfh routine, in the mountd mount daemon, returns a file handle for the 
file open as file descriptor fdes. 


nfs_getfh(fd, fhp) 
int fd: 
char *fhp; 
{ 
struct { 
int fdes; 
char *fhp; 
} args; 
extern int nfssys(); 


args.fdes = fd; 
args.fhp = fhp; 
return(nfssys(2, &args)); 


} 


The nfs_svc() and async_daemon() routines allow kernel processes to have a 
user context. The nfs svc routine starts the nfsd daemon listening on socket 
sock. The socket (in 4.2BSD terminology) must be AF_INET and 
SOCK_DGRAM (protocol UDP/IP), but this is completely dependent on the local 
network transport implementation. This system call returns only if the process 
is killed. 


nfs_svc(fd) 

int fd; 

{ 
extern int nfssys (); 
return(nfssys(1, fd); 


} 
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The async_daemon routine implements the NFS biod daemon, which handles 
asynchronous J/O for an NFS client; it never returns. 


async_daemon() 
{ 
extern int nfssys(); 
return(nfssys(3, 0)); 
} 


SEE ALSO 
mountd(1M), nfsd(1M). a 
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NAME 


nice - change priority of a process 


SYNOPSIS 


int nice (incr) 
int incr; 


DESCRIPTION 


nice adds the value of incr to the nice value of the calling process. A process’s 
nice value is a non-negative number for which a more positive value results in 
lower CPU priority. 


The system allows nice values only from -8 to 39. The nice values -8 to -1 are 
not accepted unless the syslocal(SYSLRTNICE) is executed to enable the 
mechanism. The nice system call grants nice values from -8 to -1 only to 
suner-user processes. These negative mice valucs cause ihe CPU priority of the 
process to be fixed independently of CPU usage of the process. nice values from 
0 to 39 allow the system to adjust dynamically the actual CPU priority of the 
process, temporarily lowering it in proportion to the process’s recent level of 
CPU usage. If a super-user process requires a nice value below -8, or if any 
other process requests a nice value below 0, the system imposes a nice value of 
O. If any process requests a nice value above 39, the system imposes a nice 
value of 39. 


[EPERM] nice will fail and not change the nice value if incr is 
negative or greater than 39 and the effective user ID of the 
calling process is not super-user. 


SEE ALSO 


nice(1), rtpenable(1 M), exec(2). 


DIAGNOSTICS 


Upon successful completion, nice returns the new nice value minus 20. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 
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NAME 
nice - change priority of a process 


SYNOPSIS 
int nice (incr) 
int incr; 

DESCRIPTION 
nice adds the value of incr to the nice value of the calling process. A process’s 
nice value is a non-negative number for which a more positive value results in 
lower CPU priority. 


The system allows nice values only from -8 to 39. The nice values -8 to -1 are 
not accepted unless the syslocal(SYSLRTNICE) is executed to enable the 
mechanism. The nice system call grants nice values from -8 to -1 only to 
super-uscr processes. These negative nice values cause the CPU priority of the 
process to be fixed independently of CPU usage of the process. nice values from 
0 to 39 allow the system to adjust dynamically the actual CPU priority of the 
process, temporarily lowering it in proportion to the process’s recent level of 
CPU usage. If a super-user process requires a nice value below -8, or if any 
other process requests a nice value below 0, the system imposes a nice value of 
0, If any process requests a nice value above 39, the system imposes a nice 


value of 39. 

[EPERM] nice will fail and not change the nice value if incr is 
negative or greater than 39 and the effective user ID of the 
calling process is not super-user. 

SEE ALSO 
nice(1), rtpenable(1M), exec(2). 
DIAGNOSTICS 


Upon successful completion, nice returns the new nice value minus 20. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 
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NAME 
notify, unnotify, evwait, evnowait - manage notifications 


SYNOPSIS | 
#include <notify.h> 


int notify(type, arg, tag) 
ushort type; 

char *arg; 

char *tag; 


int unnotify(type, arg) 
ushort type; 

char *arg; 

ushort evwait(tag, datum) 
char **tag; 

char **datum; 


ushort evnowait(tag, datum) 
char **tag; 
char **datum; 


DESCRIPTION 
The notify system call interface allows a user process to record a number of 
events that it is interested in, and then waits for any one of them. Like select (2), 
it does synchronous YO multiplexing, but notify waits for a wider range of 
events and thus has greater functionality than select. 


The notify call requests a notification or set of notifications. 

The unnotify call retracts an earlier request (or set of requests) for notification. 
The evwait cali waits for a notification to be posted to the calling process. 

The evnowait call returns the first notification if one exists, returning 
immediately otherwise. 


Notifications are posted FIFO (first-in, (frst-out) in the user process, each 
evwait returning the first notification or blocking until one is posted. When a 
notify call is given the user must supply the type of notification, a tag, and an 
argument. The tag is an arbitrary number the size of a (char *), which is 
returned by any evwait call tnggered by that notification request. The 
argument is type specific and is described below. 


The return values of evwait and evnowait are the type of the notification. 


It is an error for notify to be called with a type and arg matching a currently 
active notification. 
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The notify calls support the following types: 


N_FDREAD 
Queue a notification if the file descriptor arg is readable at the time of 
the notify call, and subsequently whenever there is data to be read. A 
notification is also queued at end-of-file or when the number of writers 
On a pipe goes to zero. The datum returned from an evwait is a count of 
the number of bytes available to be read, unless the notification is for a 
terminal device in cooked mode; in this case, the count is actually the 
number of delimiters encountered (that is, the number of reads 
required to get all data). At EOF the datum is -1, and the request is 
deleted. This type is implemented for sockets, pipes, ttys, and streams. 


N_FDWRITE 
Queue a notification if the file descriptor arg is writable at the time of 
the notify call, and subsequently when the file goes from a non- 
writable to a writable state (that 1s, output is not blocked). Datum is 
the number of characters writable. This type is implemented for 
sockets, pipes, and streams. 


N_SIGNAL 
Queue a notification on receipt of a signal. This 1s used in conjunction 
with regular signal catching [see signal(2)]. When signal notification is 
in effect, all caught signals queue notifications instead of causing 
pseudo-interrupts. If multiple instances of a caught signal occur 
before the process has received the notification, the returned type is 
N_LOSTSIG rather than N_SIGNAL. Ignored or defaulted signals are 
handled normally. Signals are not reset upon notification. 


Note that only one call to notify 
notify(N_SIGNAL, ignored,tag) 


is required to enable notification of all signals that have a signal 
catching function (use a null function). Evwait and evnowait return the 
tag and datum. Datum is a bitwise OR of all queued signals: that is, 
low-numbered signals are represented as low-order bits (signal n sets 
ONokY: 


N_UMSGREAD, N_UMSGWRITE 
Queue a notification if the message queue described by arg is or 
becomes readable or writable, respectively. The datum returned is the 
number of messages received or the number of characters that can be 
sent, respectively. When the message queue is removed, datum is -1, 
and the request is deleted. 
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N_INDIR 
If type is N_INDIR, arg is acually a pointer to an array of the following 
structure (defined in /usr/include/notify.h): 


struct n_request { 
ushort type; 
char *arg; 
char “tag; 


} 


The array should be terminated with an entry having type N_INDIR. The entire 
set of notifications is either placed or removed. N_INDIR is never returned by 
evwait or evnowait. 


N_ QUERY 
Type N_QUERY is valid only as an argument to the notify call. arg isa 
pointer to an array of struct n_indir, and fag is a pointer to an int 
containing the number of elements in the array. 


On return, the array contains the current active notifications in a form 
suitable for passing to notify or unnotify (that is, terminated by 
N_INDIR), and the int pointed to by tag contains the number of active 
notifications (even if there was not enough space to copy them all 
back). ! 


N_SEMOP | 
Queue a notification if the semaphore described by the struct 
n_semop (below) pointed to by arg would not block, is released, or is 
removed. Datum 1s semval unless the semaphore has been removed, in 
which case it is -1. 


struct n_semop { 
intsemid; /* semaphore ID */ 
short sem_num; /* semaphore number */ 
short sem_op; /* semaphore operation */ 


SEE ALSO 
fentl(2), msgop(2), pipe(2), read(2), select(2), signal(2), socket(2), wait(2), 
termio(7). 


NOTIFY (2) 


DIAGNOSTICS 


NOTIFY(2) 


All calls return -1 on error, setting errno to one of the following: 


[EINVAL] 
[EINVAL] 
[EINVAL] 
[EBADF] 

[EBADF] 

[ENOSPC] 
[ENOSPC] 
[ENOSPC] 


[EFAULT} 
EXAMPLE 


Invalid type was given 

Caller never did a notify (unnotify, evwait, evnowait) 

File is not of a valid type (N_FDREAD, N FDWRITE). 

File is not open (N_FDREAD, N_FDWRITE) 

Invalid message queue descriptor (N_UMSG) 

No space available to allocate notification queue header 

No space available to allocate table entry for this notification 


Too many active notification requests for given space 
(N_QUERY) 


An address fault was generated by a user-supplied pointer 


#include "sys/types.h’ 
#include <sys/notify.h> 


#include <stdio.h> 
#include <signal.h> 


int sig_catch(); 


main() 


{ 


int tag, datum, i; 
char buf[BUFSIZ]; 
ushort rv, evwait(); 


setbuf(stdout, NULL); 
if (notify(N_FDREAD, 0, ‘t’) < 0) 


perror(“notify for N_FDREAD of stdin failed"), exit(1); 


if (notify(N_ SIGNAL, 2, 's’) < 0) 


perror("notify failed”), exit(1); 


for (i=0; i<20; i++) 


signal({i, sig catch); 
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for(;;) { 
/* Wait for an event */ 
rv = evwait(&tag, &datum); 


/* Tell the user about it */ 
printi("Ov: %d tag: %d datum: %d0, rv, tag, datum); 


switch (tag) { 


case's’: 
break; 
case 't’: 
/* Read the input */ 
gets(buf); 
printf("read '%e'0, buf; 
if (*buf == ’q’) 
exit(0); 
break; 
} 
} 
} 
sig catch() 
{ 
} 
WARNING 


The notify system call interface is not portable, has little likelihood of becoming 
SO, and may disappear in future releases of CTIX. It is therefore recommended 
that you use the poll(2) system call, and that existing software using notify be 
changed to use poll. 
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NAME 
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open - open for reading or writing 


SYNOPSIS 


#include <fcntl.h> 
int open (path, oflag [, mode] ) 


char *path; 


int oflag, mode; 


DESCRIPTION 


The open call opens a file descriptor for the file pointed to by path, and sets the 
file status flags according to the value of oflag. For non-STREAMS [see 
intro(2)] files, oflag values are constructed by or-ing flags from the following 
list (only one of the first three flags below may be used): 
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O_WRONLY 
O_RDWR 
O_NDELAY 


Open for reading omy. 
Open for writing only. 
Open for reading and writing. 


This flag may affect subsequent reads and writes [see 
read(2) and write (2)]. 


When opening a FIFO with O_RDONLY or O_WRONLY set: 
If O_NDELAY is set: 


An open for reading-only will return without delay. 
An open for writing-only will return an error if no 
process currently has the file open for reading. 


If O_NDELAY is clear: 


An open for reading-oniy will block until a process 
opens the file for writing. An open for writing-only 
will block until a process opens the file for reading. 


When opening a file associated with a communication line: 
If O_LNDELAY is set: 

The open will return without waiting for carrier. 
If O_NDELAY is clear: 


The open will block until carrier is present. 
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O_APPEND If set, the file pointer will be set to the end of the file prior to 
each write. 


O_ DIRECT If set, subsequent reads or writes that satisfy the following 
criteria are moved directly to or from the user space to the 
physical media: 


e The transfer must start on a 1K byte boundary in the 
file, and it must be in multiples of 1K byte blocks. 


O_ SYNC When opening a regular file, this flag affects subsequent 
writes. If set, each write(2) will wait for both the file data 
and file status to be physically updated. 


O_CREAT If the file exists, this flag has no effect. Otherwise, the 
owner ID of the file is set to the effective user ID of the 
process, the group ID of the file is set to the effective group 
ID of the process, and the low-order 12 bits of the file mode 
are set to the value of mode modified as follows [see 


creat (2)]: 
e All bits set in the file mode creation mask of the process are 
cleared [see umask (2)]. 
® The ‘‘save text image after execution bit’’ of the mode is 
cleared [see chmod (2)]. 
O TRUNC 
If the file exists, its length is truncated to 0 and the mode and owner are 
unchanged. 
O EXCL 


If O_EXCL and O_CREAT are set, open will fail if the file exists. 

When opening a STREAMS file, oflag may be constructed from O_NDELAY or- 
ed with either O_RDONLY, O_WRONLY or O_RDWR. Other flag values are not 
applicable to STREAMS devices and have no effect on them. The value of 
O_NDELAY affects the operation of STREAMS drivers and certain system calls 
[see read(2), getmsg(2), putmsg(2) and write(2)]. For drivers, the 
implementation of O_NDELAY is device-specific. Each STREAMS device driver 
may treat this option differently. 


Certain flag values can be set following open as described in fenil(2). 


The file pointer used to mark the current position within the file is set to the 
beginning of the file. 
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The new file descriptor is set to remain open across exec system calls [see 


fentl(2)). 


The named file is opened unless one or more of the following are true: 


[EACCES] 
[EACCES] 
[EAGAIN] 


[EEXIST} 
[EFAULT] 


[EINTRI 

[EIO] 
[EISDIR] 
[EMFILE] 
[EMULTIHOP] 


[ENFILE] 


[ENOENT] 
[ENOLINK] 


[ENOMEM] 
[ENOSPC] 


{[ENOSR] 
[ENOTDIR] 
{[ENXIO] 


[ENXIO] 


[ENXIO] 
[EROFS] 


A component of the path prefix denies search permission. 
oflag permission is denied for the named file. 


The file exists, mandatory file/record locking is set, and there 
are outstanding record locks on the file [see chmod (2)). 


O_CREAT and O_EXCL are set, and the named file exists. 


path points outside the allocated address space of the 
process. 


A signal was canght during the anen system call. 

A hangup or error occurred during a STREAMS open. 

The named file is a directory and oflag is write or read/write. 
NOFILES file descriptors are currently open. 


Components of path require hopping to multiple remote 
machines, 


The system file table is full. 
O_CREAT is not set and the named file does not exist. 


path points to a remote machine, and the link to that machine 
is no longer active. 


The system is unable to allocate a send descriptor. 


O_CREAT and O_EXCL are set, and the file system is out of 
inodes. 


Unable to allocate a stream. 
A component of the path prefix is not a directory. 


The named file is a character special or block special file, 
and the device associated with this special file does not exist. 


O_NDELAY is set, the named file is a FIFO, O_WRONLY is 
set, and no process has the file open for reading. 


A STREAMS module or driver open routine failed. 


The named file resides on a read-only file system and oflag 
is write or read/write. 
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[ETXTBSY] The file is a pure procedure (shared text) file that is being 
executed and oflag is write or read/write. 


[EDEADLOCK] _ A side effect of the locking(2) call, when applying OTRUNC. 
[See the WARNING on the locking (2) manpage. ] 


SEE ALSO 
chmod(2), close(2), creat(2), dup(2), fcenti(2), getmsg(2), intro(2), Iseek(2), 


read(2), putmsg(2), umask(2), write(2). 

DIAGNOSTICS 
Upon successful completion, the file descriptor is returned. Otherwise, a value 
of -1 1s returned and errno is set to indicate the error. 
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NAME 
pause - suspend process until signal 


SYNOPSIS 
pause () 


DESCRIPTION 
The pause call suspends the calling process until it receives a signal. The 
signal must be one that is not currently set to be ignored by the calling process. 


If the signal causes termination of the calling process, pause does not return. 


If the signal is caught by the calling process and control is returned from the 
signal-catching function [see signal (2)}, the calling process resumes execution 
from the point of suspension; with a return value of -1 from pause and errno set 
to EINTR. 


SEE ALSO 
alarm(2), kill(2), signal(2), wait(2). 
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NAME 
pipe - create an interprocess channel 
SYNOPSIS 
int pipe (fildes) 
int fildes[2}; 
DESCRIPTION 


pipe creates an I/O mechanism called a pipe and returns two file descriptors, 
fildes [0] and fildes[1]. fildes [0] is opened for reading and fildes[1] is opened 
for writing. 

Up to 9,216 bytes of data are buffered by the pipe before the writing process is 
blocked. A read only file descriptor fildes{Q} accesses the data written to 
fildes [1] on a first-in-first-out (FIFO) basis. 


pipe will fail if: 


[EMFILE] NOFILES file descriptors are currently open. 
[ENFILE] The system file table is full. 

SEE ALSO 
sh(1), read(2), write(2). 

DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


plock - lock process, text, or data in memory 


SYNOPSIS 


#include <sys/lock.h> 


int plock (op) 
int op; 


DESCRIPTION 


plock allows the calling process to lock its text segment (text lock), its data and 
stack segments (data lock), or its text and data segments (process lock) into 
memory. Locked segments are immune to all routine swapping. plock also 
allows these segments to be unlocked. For 407 object modules TXTLOCK and 
DATLOCK are identical. 


The effective user ID of the calling process must be super-user to use this call. 
op specifies the following: 


PROCLOCK lock text and data segments into memory (process lock) 
TXTLOCK _ lock text segment into memory (text lock) 

DATLOCK __ lock data segment into memory (data lock) 

UNLOCK remove locks 


Shared regions (for example, text) may be locked by anyone using the text, but 
they may be unlocked only if the caller is the last one using the region. Note 
that sticky-bit text that is not explicitly unlocked will remain locked in core 
even after the last process using it terminates. 


plock will fail and not perform the requested operation if one or more of the 
following are true: 


[EPERM] The effective user ID of the calling process is not super- user. 

[EINVAL] op is equal to PROCLOCK and a process lock, a text lock, or 
a data lock already exists on the calling process. 

[EINVAL] op is equal to TXTLOCK and a text lock, or a process lock 
already exists on the calling process. 

[EINVAL] op is equal to DATLOCK and a data lock, or a process lock 
already exists on the calling process. 

[EINVAL] op is equal to UNLOCK and no type of lock exists on the 
calling process. 

([EAGAIN] Not enough memory. 
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SEE ALSO 
exec(2), exit(2), fork(2). 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned to the calling process. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 
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NAME 
poll - STREAMS input/output multiplexing 


SYNOPSIS 
#include <stropts.h> 
#include <poll.h> 


int poll(fds, nfds, timeout) 
struct pollfd fds[]; 
unsigned long nfds; 

int timeout; 


DESCRIPTION 

poll provides users with a mechanism for multiplexing input/output over a set of 
file descriptors that reference open streams [see intro(2)]. poll identifies those 
streams on which a user can send or receive messages, or on which certain 
events have occurred. A user can receive messages using read(2) or getmsg(2) 
and can send messages using wrife(2) and putmsg(2). Certain ioctl(2) calls, 
such as I RECVFD and I_SENDFD [see streamio(7)], can also be used to receive 
and send messages. 


fds specifies the file descriptors to be examined and the events of interest for 
each file descriptor. It is a pointer to an array with one element for each open 
file descriptor of interest. The array’s elements are pollfd structures which 
contain the following members: 


int fd; /* file descriptor */ 
short events; /* requested events */ 
short revents; /* returned events */ 


where fd specifies an open file descriptor and events and revents are bitmasks 
constructed by or-ing any combination of the following event flags: 


POLLIN A non-priority or file descriptor passing message (see 
I_RECVFD) is present on the stream head read queue. This flag 
is set even if the message is of zero length. In revents, this flag 
is mutually exclusive with POLLPRI. 


POLLPRI A priority message is present on the stream head read queue. 
This flag is set even if the message is of zero length. In revents, 
this flag is mutually exclusive with POLLIN. 


POLLOUT The first downstream write queue in the stream is not full. 
Priority control messages can be sent (see putmsg) at any time. 
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POLLERR An error message has arrived at the stream head. This flag is 
only valid in the revents bitmask; it is not used in the events 
field. 


POLLHUP A hangup has occurred on the stream. This event and POLLOUT 
are mutually exclusive; a stream can never be writable if a 
hangup has occurred. However, this event and POLLIN or 
POLLPRI are not mutualiy exciusive. This fiag is only valid in 
the revents bitmask; it is not used in the events field. 

POLLNVAL _ The specified fd value does not belong to an open stream. This 
flag is only valid in the revents field; it is not used in the events 
field. 


For each element of the array pointed to by fds, poll examines the given file 
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be examined 1s specified by nfds. If nfds exceeds NOFILES, the system limit of 
open files [see ulimit(2)}, poll will fail. 


If the value fd is less than zero, events is ignored and revents is set to 0 in that 
entry on return from poll. 


The results of the poll query are stored in the revents field in the pollfd 
structure. Bits are set in the revents bitmask to indicate which of the requested 
events are true. If none are true, none of the specified bits 1s set in revents when 
the poll call returns. The event flags POLLHUP, POLLERR and POLLNVAL are 
always set in revents if the conditions they indicate are true; this occurs even 
though these flags were not present in events. 


If none of the defined events have occurred on any selected file descriptor, poll 
waits at least timeout msec for an event to occur on any of the selected file 
descriptors. On a computer where millisecond timing accuracy is not available, 
timeout is rounded up to the nearest legal value available on that system. If the 
value timeout is O, poll returns immediately. If the value of timeout is -1, poll 
blocks until a requested event occurs or until the call is interrupted. poll is not 
affected by the O_NDELAY flag. 


poll fails if one or more of the following are true: 


[EAGAIN] Allocation of internal data structures failed but request should 
be attempted again. 

[EFAULT] Some argument points outside the allocated address space. 

[EINTR] A signal was caught during the poll system call. 

[EINVAL] The argument nfds is less than zero, or nfds is greater than 
NOFILES. 
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SEE ALSO 
intro(2), read(2), getmsg(2), putmsg(2), write(2), streamio(7). 
UNIX System V Release 3.2 Streams Primer. 
UNIX System V Release 3.2 Streams Programmer s Guide. 


DIAGNOSTICS 
Upon successful completion, a non-negative value is returned. A positive value 
indicates the total number of file descriptors that has been selected (that is, file 
descriptors for which the revents field is non-zero). A value of 0 indicates that 
the call timed out and no file descriptors have been selected. Upon failure, a 
value of -1 is returned and errno is set to indicate the error. 
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NAME 


profil - execution time profile 


SYNOPSIS 


void profil (buff, bufsiz, offset, scale) 
char *buff; 
int bufsiz, offset, scale; 


DESCRIPTION 


buff points to an area of core whose length (in bytes) is given by bufsiz. After 
this call, the user’s program counter (pc) is examined each clock tick. Then the 
value of offset is subtracted from it, and the remainder multiplied by scale. If 
the resulting number corresponds to an entry inside buff, that entry is 
incremented. An entry is defined as a series of bytes with length sizeof(short). 
The scale is interpreted as ai unsigned, fixed-poini fraction with binary point at 
the left: 0177777 (octal) gives a 1-1 mapping of pc’s to entries in buff; 077777 
(octal) maps each pair of instruction entries together. O2(octal) maps all 
instructions onto the beginning of buff (producing a non-interrupting core 
Clock). 


Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by 
giving a bufsiz of 0. Profiling is turned off when an exec is executed, but 
remains on in child and parent both after a fork. Profiling will be turned off if 
an update in buff would cause a memory fault. 


SEE ALSO 


prof(1), times(2), monitor(3C). 


DIAGNOSTICS 


Not defined. 
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NAME 
ptrace - process trace 


SYNOPSIS 
int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 


DESCRIPTION 

ptrace provides a means by which a parent process may control the execution 
of a child process. Its primary use is for the implementation of breakpoint 
debugging [see sdb(1)]. The child process behaves normally until it encounters 
a signal [see signal (2) for the list], at which time it enters a stopped state and its 
parent is notified via wait(2). When the child is in the stopped state, its parent 
can examine and modify its “‘core image’’ using ptrace. Also, the parent can 
cause the child either to terminate or continue, with the nossibility of ignoring 
the signal that caused it to stop. 


The request argument determines the precise action to be taken by ptrace and is 
one of the following: 


0 This request must be issued by the child process if it is to be traced by 
its parent. It turns on the child’s trace flag that stipulates that the child 
should be left in a stopped state upon receipt of a signal rather than the 
State specified by func [see signal(2)]. The pid, addr, and data 
arguments are ignored, and a return value is not defined for this 
request. Peculiar results will ensue if the parent does not expect to 
trace the child. 


The remainder of the requests can be used only by the parent process. For each, 
pid is the process ID of the child. The child must be in a stopped state before 
these requests are made. 


1,2 With these requests, the word at location addr in the address space of 
the child is returned to the parent process. If I and D space are 
separated, request I returns a word from I space, and request 2 returns 
a word from D space. If I and D space are not separated, either request 
1 or request 2 may be used with equal results. The data argument is 
ignored. These two requests will fail if addr is not the start address of 
a word, in which case a value of -1 is returned to the parent process 
and the parent’s errno is set to EIO. 


3 With this request, the word at location addr in the child’s USER area in 
the system’s address space (see <sys/user.h>) is returned to the parent 
process. Addresses in this area range from 0 to ctob (USIZE) on 
Convergent Technologies 680x0-family processors. The data 
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4,5 
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argument is ignored. This request will fail if addr is not the start 
address of a word or is outside the USER area, in which case a value of 
-1 is returned to the parent process and the parent’s errno is set to EIO. 


With these requests, the value given by the data argument is written 
into the address space of the child at location addr. If I and D space 
are separated (as on PDP-11), request 4 writes a word into I space, and 
request 5 writes a word into D space. If I and D space are noi 
separated (as on Convergent Technologies 680x0-family processors) 
either request 4 or request 5 may be used with equal results. Upon 
successful completion, the value written into the address space of the 
child is returned to the parent. These two requests will fail if addr is 
not the start address of a word. Upon failure a value of -1 is returned 
to the parent process and the parent’s errno is set to EIO. 


With this request, a few entries in the child’s USER area can be written. 
Data gives the value that is to be written and addr is the location of 
the entry. The few entries that can be written are: 


e the general registers (that is, registers 0 to 15 on Convergent 
Technologies 680x0-family processors) 


@ the condition codes of the Processor Status Word. 


This request causes the child to resume execution. If the data 
argument is 0, all pending signals including the one that caused the 
child to stop are canceled before it resumes execution. If the data 
argument is a valid signal number, the child resumes execution as if it 
had incurred that signal, and any other pending signals are canceled. 
The addr argument must be equal to 1 for this request. Upon 
successful completion, the value of data is returned to the parent. 
This request will fail if data is not 0 or a valid signal number, in which 
case a value of -1 is returned to the parent process and the parent’s 
errno is set to EIO. 


This request causes the child to terminate with the same consequences 
as exit(2). 


This request sets the trace bit in the Processor Status Word of the child 
and then executes the same steps as listed above for request 7. The 
trace bit causes an interrupt upon completion of one machine 
instruction. This effectively allows single stepping of the child. 


To forestall possible fraud, ptrace inhibits the set-user-ID facility on subsequent 
exec(2) calls. If a traced process calls exec, it will stop before executing the 
first instruction of the new image showing signal SIGTRAP. 


<0. 
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General Errors 
ptrace will in general fail if one or more of the following are true: 


[EIO] request is an illegal number. 


[ESRCH] pid identfies a child that does not exist or has not executed a 
ptrace with request 0. 
SEE ALSO 
sdb(1), exec(2), signal(2), wait(2). 
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NAME 
putmsg - send a message on a stream 


SYNOPSIS 
#include <stropts.h> 


int putmsg (fd, ctlptr, dataptr, flags) 
int fd; 
Struct strbuf *ctlptr; 
struct strbuf *dataptr; 
int flags; 

DESCRIPTION 
The putmsg call creates a message [see intro(2)] from user specified buffer(s) 
and sends the message to a STREAMS file. The message can contain either a 
Gaia pati, a control part or both. The data and coniroi parts to be sent are 
distinguished by placement in separate buffers, as described below. The 
semantics of each part is defined by the STREAMS module that receives the 
message. 


fd specifies a file descriptor referencing an open Stream; ctlptr and dataptr each 
point to a strbuf structure which contains the following members: 


int maxien; /* not used */ 
int len; /* length of data */ 
char *buf; /* ptr to buffer */ 


ctlptr points to the structure describing the control part, if any, to be included in 
the message. The buf field in the strbuf structure points to the buffer where the 
control information resides, and the /en field indicates the number of bytes to be 
sent. The maxilen field is not used in putmsg [see getmsg(2)]. In a similar 
manner, dataptr specifies the data, if any, to be included in the message. flags 
may be set to the values 0 or RS_HIPRI and is used as described below. 


To send the data part of a message, dataptr must be non-NULL and the /en field 
of dataptr must have a value of 0 or greater. To send the control part of a 
message, the corresponding values must be set for ctlptr. No data (control) part 
will be sent if either dataptr (ctlptr) is NULL or the len field of dataptr (ctiptr) 
iS set to -1. 


If a control part is specified, and flags is set to RS_HIPRI, a priority message is 
sent. If flags is set to 0, a non-priority message is sent. If no control part is 
specified, and flags is set to RS_HIPRI, putmsg fails and sets errno to EINVAL. 
If no control part and no data part are specified, and flags is set to 0, no message 
is sent, and 0 is returned. 
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For non-priority messages, putmsg will block if the stream write queue is full 
due to internal flow control conditions. For priority messages, putmsg does not 
block on this condition. For non-priority messages, putmsg does not block 
when the write queue is full and O_NDELAY is set. Instead, it fails and sets 
errno to EAGAIN. 


putmsg also blocks, unless prevented by lack of internal resources, waiting for 
the availability of message blocks in the stream, regardless of priority or 
whether O_NDELAY has been specified. No partial message is sent. 


putmsg fails if one or more of the following are true: 


[EAGAIN] A non-priority message was specified, the O_NDELAY flag is 
set and the stream write queue is full due to internal flow 
control conditions. 


[EAGAIN] Buffers could not be allocated for the message that was to be 


created. 

[EBADF] fd is not a valid file descriptor open for writing. 

[EFAULT] ctlptr or dataptr points outside the allocated address space. 

[EINTR] A signal was caught during the putmsg system call. 

[EINVAL] An undefined value was specified in flags, or flags is set to 
RS_HIPRI and no control part was supplied. 

[EINVAL] The stream referenced by fd is linked below a multiplexor. 

[ENOSTR] A stream is not associated with fd. 

[ENXIO] A hangup condition was generated downstream for the 
specified stream. 


[ERANGE] The size of the data part of the message does not fall within the 
range specified by the maximum and minimum packet sizes of 
the topmost stream module. This value is also returned if the 
control part of the message is larger than the maximum 
configured size of the control part of a message, or if the data 
part of a message is larger than the maximum configured size 
of the data part of a message. 


A putmsg also fails if a STREAMS error message had been processed by the 
stream head before the call to putmsg. The error returned is the value contained 
in the STREAMS error message. 
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SEE ALSO 
intro(2), read(2), getmsg(2), poll(2), write(2). 
UNIX System V Release 3.2 Streams Programmer's Guide. 
UNIX System V Release 3.2 Streams Primer. 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and e77no is Sei io indicate the error. 
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NAME 


read - read from file 


SYNOPSIS 


int read (fildes, buf, nbyte) 
int fildes; 

char *buf; 

unsigned nbyte; 


DESCRIPTION 


The fildes argument is a file descriptor obtained from a creat(2), open(2), 
dup(2), fentl (2), or pipe (2) system call. 


The read call attempts to read nbyte bytes from the file associated with fildes 
into the buffer pointed to by buf. 


On devices capable of seeking, the read starts at a position in the file given by 
the file pointer associated with fildes. Upon return from read, the file pointer is 
incremented by the number of bytes actually read. 


Devices that are incapable of seeking always read from the current position. 
The value of a file pointer associated with such a file is undefined. 


Upon successful completion, read returns the number of bytes actually read and 
placed in the buffer; this number may be less than nbyte if the file is associated 
with a communication line [see ioctl(2) and termio(7)], or if the number of 
bytes left in the file is less than nbyte bytes. A value of 0 is returned when an 
end-of-file has been reached. 


A read from a STREAMS [see intro(2)] file can operate in three different modes: 
**byte-stream’’ mode, “‘message-nondiscard’’ mode, and ‘‘message-discard’’ 
mode. The default is byte-stream mode. This can be changed using the 
I_SRDOPT ioctl request [see streamio(7)], and can be tested with the I GRDOPT 
ioctl. In byte-stream mode, read retrieves data from the stream until it has 
retrieved nbyte bytes, or until there is no more data to be retrieved. Byte- 
stream mode ignores message boundaries. 


In STREAMS message-nondiscard mode, read retrieves data until it has read 
nbyte bytes, or until it reaches a message boundary. If the read does not 
retrieve all the data in a message, the remaining data are replaced on the stream, 
and can be retrieved by the next read or getmsg(2) call. Message- discard mode 
also retrieves data until it has retrieved nbyte bytes, or it reaches a message 
boundary. However, unread data remaining in a message after the read returns 
are discarded, and are not available for a subsequent read or getmsg. 
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When attempting to read from a regular file with mandatory file/record locking 
set [see chmod(2)], and there is a blocking (owned by another process) write 
lock on the segment of the file to be read: 


@ If O_NDELAY is set, the read returns a -1 and set errno to EAGAIN. 
6 If O_NDELAY is clear, the read sleeps until the blocking record lock is 
TOMOved. 
When attempting to read from an empty pipe (or FIFO): 
® If O_NDELAY is set, the read returns a 0. 


6 If O_NDELAY is clear, the read blocks until data is written to the file or 
the file is no longer open for writing. 


When attempting to read a file associated with a tty that has no data currently 
available: 


® If O_NDELAY is set, the read returns 0. 
® If O_NDELAY is clear, the read blocks until data becomes available. 


When attempting to read a file associated with a stream that has no data 
currently available: 


e If O_NDELAY is set, the read returns a -1 and set errno to EAGAIN. 
@ If O_NDELAY is clear, the read blocks until data becomes available. 


When reading from a STREAMS file, handling of zero-byte messages is 
determined by the current read mode setting. In byte-stream mode, read 
accepts data until it has read nbyte bytes, or until there is no more data to read, 
or until a zero-byte message block is encountered. The read call then returns 
the number of bytes read, and places the zero- byte message back on the stream 
to be retrieved by the next read or getmsg. In the two other modes, a zero-byte 
message returns a value of 0 and the message is removed from the stream. 
When a zero- byte message is read as the first message on a stream, a value of 0 
is returned regardless of the read mode. 


A read from a STREAMS file can only process data messages. It cannot process 
any type of protocol message and fails if a protocol message is encountered at 
the stream head. 


The read call fails if one or more of the following are true: 


[EAGAIN] Mandatory file/record locking was set, O_NDELAY was set, 
and there was a blocking record lock. 


[EAGAIN] Total amount of system memory available when reading via 
raw IO is temporarily insufficient. 


Le 
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[EAGAIN] 


[EBADF] 
[EBADMSG] 


[EDEADLK]} 


[EFAULT] 
[EINTR] 
[EINVAL] 
[ENOLCK] 


[ENOLINK] 


[EDEADLOCK] 


READ(2) 


No message waiting to be read on a stream and O_NDELAY 
flag set. 


fildes is not a valid file descriptor open for reading. 


Message waiting to be read on a stream is not a data 
message. 


The read was going io go to siceep and cause a deadlock 
situation to occur. 

buf points outside the allocated address space. 

A Signal was caught during the read system call. 

Attempted to read from a stream linked to a multiplexor. 

The system record lock table was full, so the read could not 
go to sleep until the blocking record lock was removed. 


fildes ts on a remote machine and the link to that machine is 
no longer active. 


A side effect of the locking(2) call. (See the WARNING on 
the locking (2) manpage.) 


A read from a STREAMS file also fails if an error message is received at the 
stream head. In this case, errno is set to the value returned in the error 
message. If a hangup occurs on the stream being read, read continues to 
operate normally until the stream head read queue is empty. Thereafter, it 


returns Q. 


SEE ALSO 


creat(2), dup(2), fcntl(2), getmsg(2), ioctl(2), intro(2), locking(2), open(2), 
pipe(2), streamio(7), termio(7). 


DIAGNOSTICS 


Upon successful completion a non-negative integer is returned indicating the 
number of bytes actually read. Otherwise, a -1 is returned and errno is set to 


indicate the error. 
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NAME 
recy, recvfrom - receive a message from a socket 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


int recv(s, buf, len, flags) 
int s; 

char *buf; 

int len, flags; 


int recvfrom(s, buf, len, flags, from, fromlen) 
int s; 

char *buf; 

int ien, flags; 

struct sockaddr *from; 

int *fromlen; 


DESCRIPTION 
The recv and recvfrom calls are used to receive messages from a socket. 


The recy call can be used only on a connected socket [see connect(2)], while 
recvfrom can be used to receive data on a socket whether it is in a connected 
state or not. 


If from is non-zero, the source address of the message is filled in. fromlen is a 
value-result parameter, initialized to the size of the buffer associated with from, 
and modified on return to indicate the actual size of the address stored there. 
The length of the message is returned in cc. If a message is too long to fit in the 
supplied buffer, excess bytes may be discarded depending on the type of socket 
the message is received from; see socket(2). 


If no messages are available at the socket, the receive call waits for a message 
to arrive. 


The flags argument to a send call is formed by or’ing one or more of the values: 


#define MSG PEEK 0x1 /* peek at incoming message */ 
#define MSG_OOB 0x2 _ = / process out-of-band data */ 


RETURN VALUE 
These calls return the number of bytes received, or -1 if an error occurred. 
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ERRORS 
The calls fail if: 
[EBADF} The argument s is an invalid descriptor. 
[ENOTSOCK] The argument s is not a socket. 
[EINTR] The receive was interrupted by delivery of a signal 
before any data was availabie for the receive. 
[EFAULT] The data was specified to be received into a non- 
existent or protected part of the process address space. 
SEE ALSO 


connect(2), intro(2), read(2), send(2), socket(2), intro(7). 
CTIX Network Programmer's Primer. 
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NAME 
rmdir - remove a directory 


SYNOPSIS 
int rmdir (path) 
char *path; 


DESCRIPTION 


The rmdir call removes the directory named by the path name pointed to by 
path. The directory must not have any entries other than the dot (.) and dot dot 


(..) files. 


The named directory ts removed unless one or more of the following are true: 


[EINVAL] 
[EINVAL] 
[EEXIST] 


{ENOTDIR] 


[ENOENT] 
[EACCES] 


[EACCES] 


[EACCES] 


[EBUSY] 


[EROFS] 


([EFAULT] 
[EIO] 
[ENOLINK] 


[EMULTIHOP] 


The current directory should not be removed. 


4 3 1A nanan ha anne meen wl 
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The directory contains entries other than those for dot (.) 
and dot dot (..). 


A component of the path prefix is not a directory. 
The named directory does not exist. 


Search permission is denied for a component of the path 
prefix. 


Write permission is denied on the directory containing the 
directory to be removed. 


The parent directory has the sticky bit set and: the parent 
directory is not owned by the user; and the directory is not 
owned by the user; and the directory is not writable by the 
user; and the user is not super-user. 


The directory to be removed is the mount point for a 
mounted file system. 


The directory entry to be removed is part of a read-only file 
system. 


Path points outside the process’s allocated address space. 
An I/O error occurred while accessing the file system. 


Path points to a remote machine, and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 
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SEE ALSO 
mkdir(1), rm(1), rmdir(1), mkdir(2). 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 
select - synchronous I/O multiplexing 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/time.h> 
#include <sys/socket.h> 


nfound = select(nfds, readfds, writefds, exceptfds, timeout) 
int nfound, nfds; 

fd_set *readfds, *writefds, *exceptfds; 

struct timeval *timeout; 


FD _ SET(fd, &fdset) 
FD _CLR(fd, &fdset) 
FD_ISSET(fd, &fdset) 
FD ZERO(&fdset) 
int fd; 

fd_set fdset; 


DESCRIPTION 

The select call examines the I/O descriptor sets whose addresses are passed in 
readfds, writefds, and exceptfds to see if some of their descriptors are ready for 
reading, are ready for writing, or have an exceptional condition pending, 
respectively. The first nfds descriptors are checked in each set; that is, the 
descriptors from 0 through nfds-1 in the descriptor sets are examined. On 
return, select replaces the given descriptor sets with subsets consisting of those 
descriptors that are ready for the requested operation. The total number of 
ready descriptors in all the sets is returned in nfound. 


The descriptor sets are stored as bit fields in arrays of integers. The following 
macros are provided for manipulating such descriptor sets: D ZERO(&fdset) 
initializes a descriptor set fdset to the null set. FD SET(fd, &fdset) includes a 
particular descriptor fd in fdset. FD_CLR(fd, &fdset) removes fd from fdset. 
FD_ISSET(fd, &fdset) is nonzero if fd is a member of fdset, otherwiseit is zero. 
The behavior of these macros is undefined if a descriptor value is less than zero 
or greater than or equal to FD_SETSIZE, which 1s normally at least equal to the 
maximum number of descriptors supported by the system. 


If timeout is a non-zero pointer, it specifies a maximum interval to wait for the 
selection to complete. If timeout is a zero pointer, the select blocks indefinitely. 
To affect a poll, the timeout argument should be non-zero, pointing to a zero- 
valued timeval structure. 
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Any of readfds, writefds, and exceptfds may be given as zero pointers if no 
descriptors are of interest. 


SEE ALSO 
accept(2), connect(2), getdtablesize(2), read(2), recv(2), send(2), write(2). 
CTIX Network Programmer's Primer. 


RETURN VALUE 
The select call returns the number of ready descriptors that are contained in the 
descriptor sets, or -] if an error occurred. If the time limit expires then select 
returns 0. If select returns with an error, including one due to an interrupted 
call, the descriptor sets will be unmodified. 


ERRORS 
Returned error codes from select are as follows: 


[EBADF] One of the descriptor sets specified an invalid descriptor. 


[EINTR] A signal was delivered before the time limit expired and 
before any of the selected events occurred. 


[EINVAL] The specified time limit is invalid. One of its components is 
negative or too large. 


BUGS 

Although the provision of getdtablesize (2) was intended to allow user programs 
to be written independent of the kernel limit on the number of open files, the 
dimension of a sufficiently large bit field for select remains a problem. The 
default size FD_SETSIZE (currently 256) is somewhat larger than the current 
kernel limit to the number of open files. However, in order to accommodate 
programs that might potentially use a larger number of open files with select, 
you can to increase this size within a program by providing a larger definition 
of FD_SETSIZE before the inclusion of <sys/types.h>. 


The select call should probably return the time remaining from the original 
timeout, if any, by modifying the time value in place. This may be 
implemented in future versions of the system. Thus, it is unwise to assume that 
the timeout value will be unmodified by the select call. 
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NAME 
semctl - semaphore control operations 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semctl (semid, semnum, cmd, arg) 
int semid, cmd; 
int semnum; 
union semun { 
int val; 
Struct semid ds *buf; 
ushort *array; 
} arg; 


DESCRIPTION 
The semctl call provides a variety of semaphore control operations as specified 
by cmd. 
The following cmds are executed with respect to the semaphore specified by 
semid and semnum: 


GETVAL Return the value of semval [see intro(2)]. {READ} 


SET VAL Set the value of semval to arg.val. {ALTER} When this cmd 
is successfully executed, the semadj value corresponding to 
the specified semaphore in all processes is cleared. 


GETPID Return the value of sempid. {READ} 
GETNCNT Return the value of semncnt. {READ} 
GETZCNT Return the value of semzcnt. (READ} 
The following cmds return and set, respectively, every semval in the set of 
semaphores. 
GETALL 
Place semvals into array pointed to by arg.array. (READ) 
SETALL 


Set semvals according to the array pointed to by arg.array. {ALTER} 
When this cmd is successfully executed the semadj values 
corresponding to each specified semaphore in all processes are 
cleared. 
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The following cmds are also available: 


IPC_STAT 
Place the current value of each member of the data structure associated 
with semid into the structure pointed to by arg.buf. The contents of 
this structure are defined in intro(2). {READ} 

IPC SET 
Set the value of the following members of the data structure associated 
with semid to the corresponding value found in the structure pointed to 

by arg.buf: 


sem_perm.uld 
sem_perm.gid 
sem_perm.mode /* only low 9 bits */ 


This cmd can be executed only by a process that has an effective user 
ID equal to either that of super-user, or to the value of sem_perm.cuid 
or sem_perm.uid in the data structure associated with semid. 


IPC_RMID 
Remove the semaphore identifier specified by semid from the system 
and destroy the set of semaphores and data structure associated with it. 
This cmd can only be executed by a process that has an effective user 
ID equal to either that of super-user, or to the value of sem_perm.cuid 
or sem_perm.uid in the data structure associated with semid. 


The semcil call fails if one or more of the following are true: 


[EINVAL] semid is not a valid semaphore identifier. 

[EINVAL] semnum is less than zero or greater than sem_nsems. 

[EINVAL] cmd is not a valid command. 

[EACCES] Operation permission is denied to the calling process [see 
intro(2)]. 

[ERANGE] cmd is SETVAL or SETALL and the value to which semval is 
to be set is greater than the system imposed maximum. 

[EPERM] cmd is equal to IPC_RMID or IPC_SET and the effective user 


ID of the calling process is not equal to that of super-user, or 
to the value of sem_perm.cuid or sem_perm.uid in the data 
structure associated with semid. 


[EFAULT] arg.buf points to an illegal address. 
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SEE ALSO 
intro(2), semget(2), semop(2). 
DIAGNOSTICS 
Upon successful completion, the value returned depends on cmd as follows: 
GETVAL The value of semval. 
GETPID The value of sempid. 
GETNCNT The value of semncnt. 
GETZCNT The value of semzcnt. 
All others A value of 0. 


Otherwise, a value of -1 is returned and errno is set to indicate the error. 
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NAME 


semget - get set of semaphores 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semget (key, nsems, semflg) 
key t key; 
int nsems, semflg; 


DESCRIPTION 


The semget call returns the semaphore identifier associated with key. 


A semaphore identifier and associated data structure and set containing nsems 
semaphores [see intro(2)] are created for key if one of the following is true: 


e Key is equal to IPC_PRIVATE. 


° Key does not already have a semaphore identifier associated with it, 
and (semflg & IPC_CREAT) is ‘‘true’’. 
Upon creation, the data structure associated with the new semaphore identifier 
is initialized as follows: 
e sem_perm.cuid, sem_perm.uid, sem_perm.gid, and sem_perm.cgid 
are set equal to the effective user ID and effective group ID, 
respectively, of the calling process. 


e The low-order 9 bits of sem_perm.mode are set equal to the low-order 
9 bits of semflg. 

° sem_nsems is set equal to the value of nsems. 

° sem_otime is set equal to 0 and sem_ctime is set equal to the current 
time, 


The semget call fails if one or more of the following are true: 


[EINVAL] nsems is either less than or equal to zero or greater than the 
system-imposed limit. 

[EACCES] A semaphore identifier exists for key, but operation 
permission [see intro(2)}| as specified by the low-order 9 bits 
of semflg would not be granted. 

[EINVAL] A semaphore identifier exists for key, but the number of 


semaphores in the set associated with it is less than nsems, 
and nsems is not equal to zero. 


-l- 
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[ENOENT] 


[ENOSPC] 


[ENOSPC] 


{[EEXIST] 


SEE ALSO 


SEMGET (2) 


A semaphore identifier does not exist for key and (semflg & 
IPC_CREAT) is ‘‘false’’. 


A semaphore identifier is to be created but the system- 
imposed limit on the maximum number of allowed 
semaphore identifiers system wide would be exceeded. 


A semaphore identifier is to be created but the system- 
imposed limit on the maximum number of allowed 
semaphores system wide would be exceeded. 


A semaphore identifier exists for key but [(semflg & 
IPC_CREAT) and (semflg & IPC_EXCL)] is ‘‘true’’. 


intro(2), semctl(2), semop(2). 


DIAGNOSTICS 


Upon successful completion, a non-negative integer, namely a semaphore 
identifier, 1s returned; otherwise, a value of -1 is returned and errno is set to 


indicate the error. 
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NAME 
semop - semaphore operations 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semop (semid, sops, nsops) 
int semid; 

struct sembuf **sops; 
unsigned nsops; 


DESCRIPTION 
The semop call is used to automatically perform an array of semaphore 
anerations on the set of semaphores associated with the semapnore ideniifier 
specified by semid. The sops parameter is a pointer to the array of semaphore- 
Operation structures; nsops is the number of such structures in the array. The 
contents of each structure includes the following members: 


short sem_num; /* semaphore number */ 
short sem_op;  /* semaphore operation +/ 
short sem_fig;  /* operation flags +/ 


Each semaphore operation specified by sem op is performed on the 
corresponding semaphore specified by semid and sem_num. 


The sem_op member specifies one of three semaphore operations as follows: 
e If sem_op is a negative integer, one of the following occurs {ALTER}: 


- If semval [see intro(2)] is greater than or equal to the absolute 
value of sem_op, the absolute value of sem_op is subtracted 
from semval. Also, if (sem_flg & SEM_UNDO) is “‘true’’, the 
absolute value of sem_op is added to the calling process’s 
semadj value [see exit(2)] for the specified semaphore. 


- If semval is less than the absolute value of sem op and 
(sem flg & IPC_NOWAIT) is ‘‘true’’, semop returns 
immediately. 


- If semval is less than the absolute value of sem_op and 
(sem_flg & IPC_NOWAIT) is ‘‘false’’, semop increments the 
semncnt associated with the specified semaphore and 
suspends execution of the calling process until one of the 
following conditions occur. 
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Semval becomes greater than or equal to the absolute 
value of sem_op. When this occurs, the value of 
semncnt associated with the specified semaphore is 
decremented, the absolute value of sem_op is 
subtracted from semval and, if (sem_flg & 
SEM_UNDO) is ‘“‘true’’, the absolute value of 
sem op is added to the calling process’s semad; 


value for the specified semaphore. 


The semid for which the calling process is awaiting 
action is removed from the system [see semcti(2)]. 
When this occurs, errno 1s set equal to EIDRM, and a 
value of -1 is returned. 


The calling process receives a signal that is to be 
caught. When this occurs, the value of semncnt 
associated with the specified semaphore is 
decremented, and the calling process resumes 
execution in the manner prescribed in signal (2). 


If sem_op is a positive integer, the value of sem_op is added to semval 
and, if (sem_flg & SEM_UNDO) is ‘“‘true’’, the value of sem_op is 
subtracted from the calling process’s semadj value for the specified 
semaphore. {ALTER} 


If sem_op is zero, one of the following occurs {READ}: 


If semval is zero, semop returns immediately. 


If semval is not equal to zero and (sem_flg & IPC_NOWAIT) 
is ‘‘true’’, semop returns immediately. 


If semval is not equal to zero and (sem_flg & IPC_NOWAIT) 
is ‘‘false’’, semop increments the semzcnt associated with the 
specified semaphore and suspends execution of the calling 
process until one of the following occurs: 


+ 


Semval becomes zero, at which time the value of 
semzcnt associated with the specified semaphore is 
decremented. 


The semid for which the calling process is awaiting 
action is removed from the system. When this 
occurs, errno is set equal to EIDRM, and a value of -1 
is returned. 
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+ The calling process receives a signal that is to be 
caught. When this occurs, the value of semzcnt 
associated with the specified semaphore is 
decremented, and the calling process resumes 
execution in the manner prescribed in signal (2). 


The semop call fails if one or more of the following are true for any of the 
semaphore operations specified by sops: 


[EINVAL] 
(EFBIG] 


[E2BIG} 
[EACCES] 


[EAGAIN] 


[ENOSPC] 


[EINVAL] 


[ERANGE] 


[ERANGE] 


{EFAULT] 


semid is not a valid semaphore identifier. 


sem_num is less than zero or greater than or equal to the 
number of semaphores in the set associated with semid. 


nsops is greater than the system-imposed maximum. 


Operation permission is denied to the calling process [see 
intro(2)] 


The operation would result in suspension of the calling 
process but (sem_flg & IPC_NOWAIT) is “‘true’’. 


The limit on the number of individual processes requesting 
an SEM_UNDO would be exceeded. 


The number of individual semaphores for which the calling 
process requests aSEM_ UNDO would exceed the limit. 


An operation would cause a semval to overflow the system- 
imposed limit. 

An operation would cause a semadj value to overflow the 
system-imposed limit. 


sops points to an illegal address. 


Upon successful completion, the value of sempid for each semaphore specified 
in the array pointed to by sops is set equal to the process ID of the calling 


process. 
SEE ALSO 


exec(2), exit(2), fork(2), intro(2), semctl(2), semget(2). 


DIAGNOSTICS 


If semop returns due to the receipt of a signal, a value of -1 is returned to the 
calling process and errno is set to EINTR. If it returns due to the removal of a 
semid from the system, a value of -1 is returned and errno is set to EIDRM. 


Upon successful completion, a value of zero is returned; otherwise, a value of 
-1 is returned and errno is set to indicate the error. 
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NAME 
send, sendto - send a message to a socket 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


int send(s, msg, len, flags) 
int s; 

char *msg; 

int len, flags; 


int sendto(s, msg, len, flags, to, tolen) 
int s; 

char *msg; 

int len, flags; 

struct sockaddr *to; 

int tolen; 


DESCRIPTION 
The send and sendto calls are used to transmit a message to another socket (s). 
The send call can be used only when the socket is in a connected state, while 
sendto can be used at any time. 


The address of the target is given by to with tolen specifying its size. The 
length of the message is given by len. If the message is too long to pass 
atomically through the underlying protocol, then the error EMSGSIZE is 
returned, and the message is not transmitted. 


No indication of failure to deliver is implicit in a send. Return values of -1 
indicate some locally detected errors. 


If no message space is available at the socket to hold the message to be 
transmitted, send blocks. 


The flags parameter can be set to SOF_OOB to send ‘‘out-of-band’’ data on 
sockets which support this notion (SOCK_STREAM). 


SEE ALSO 
intro(2), recv(2), socket(2), intro(7). 
CTIX Network Programmer’ s Primer. 


RETURN VALUE 
The call returns the number of characters sent, or -1 if an error occurred. 
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ERRORS 
[EBADF] 
[ENOTSOCK] 
[EFAULT] 


[EMSGSIZE] 


(CTIX Internetworking ) SEND (2) 


An invalid descriptor was specified. 
The argument s is not a socket. 


An invalid user space address was specified for a 
parameter. 


The socket requires that message be sent atomically, 
and the size of the message to be sent made this 
impossible. 
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NAME 
setpgrp - set process group ID 
SYNOPSIS 
int setpgrp () 
DESCRIPTION 
The setpgrp call sets the process group ID of the calling process to the process 
ID of the calling process and returns the new process group ID. 


SEE ALSO 
exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2), termio(7). 


DIAGNOSTICS 
The setpgrp call returns the value of the new process group ID. 
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NAME 
setuid, setgid - set user and group IDs 


SYNOPSIS 
int setuid (uid) 
int uid; 
int setgid (gid) 
int gid; 
DESCRIPTION 
The setuid (setgid) call is used to set the real user (group) ID and effective user 
(group) ID of the calling process. 


If the effective user ID of the calling process is super-user, the real user (group) 
ID and effective user (group) ID are set to uid (gid). 


If the effective user ID of the calling process is not super-user, but its real user 
(group) ID 1s equal to uid (gid), the effective user (group) ID is set to uid (gid). 


If the effective user ID of the calling process is not super-user, but the saved 
set-user (group) ID from exec(2) is equal to uid (gid), the effective user (group) 
ID is set to uid (gid). 


The setuid (setgid) call fails if any of the following conditions are true: 
[EPERM] 


The real user (group) ID of the calling process is not equal to uid (gid) 
and its effective user ID is not super-user. 


[EINVAL] 
The uid is out of range. 


SEE ALSO 
getuid(2), intro(2). 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned; otherwise, a value of -1 is 
returned and errno is set to indicate the error. 
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NAME 


SHMCTL(2) 


shmctl - shared memory control operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


int shmctl (shmid, cmd, buf) 


int shmid, cmd; 


struct shmid_ds *buf; 


DESCRIPTION 


The shmctl call provides a variety of shared memory control operations as 
specified by cmd. The following cmds are available: 


ifC_STAT 


IPC_SET 


IPC_RMID 


SHM_ LOCK 


Piace the current value of each member of the data structure 
associated with shmid into the structure pointed to by buf. 
The contents of this structure are defined in intro(2). 
{READ} 


Set the value of the following members of the data structure 
associated with shmid to the corresponding value found in 
the structure pointed to by buf: 


shm_perm.uid 
shm_perm.gid 
shm_perm.mode /* only low 9 bits */ 


This cmd can be executed only by a process that has an 
effective user ID equal to that of super user, or to the value of 
shm_perm.cuid or shm_perm.uid in the data structure 
associated with shmid. 


Remove the shared memory identifier specified by shmid 
from the system and destroy the shared memory segment and 
data structure associated with it. This cmd can be executed 
only by a process that has an effective user ID equal to that of 
super-user, or to the value of shm_perm.cuid or 
shm_perm.uid in the data structure associated with shmid. 


Lock the shared memory segment specified by shmid in 
memory. This cmd can be executed only by a process that 
has an effective user ID equal to super-user. 
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SHM_UNLOCK Unlock the shared memory segment specified by shmid. This 
cmd can be executed only by a process that has an effective 
user ID equal to super user. 


The shmcil call fails if one or more of the following are true: 


[EINVAL] shmid is not a valid shared memory identifier. 

[EINVAL] cmd is not a valid command. 

[EACCES] cmd is equal to IPC_STAT and {READ} operation permission 
is denied to the calling process [see intro (2)]. 

[EPERM] cmd is equal to IPC_RMID or IPC_SET and the effective user 


ID of the calling process is not equal to that of super-user, or 
to the value of shm_perm.cuid or shm_perm.uid in the data 
structure associated with shmid. 


{[EPERM] cmd is equal to SHM_LOCK or SHM_UNLOCK and the 
effective user ID of the calling process is not equal to that of 
super-user. 

[EFAULT] buf points to an illegal address. 

[ENOMEM] cmd is equal to SHM_LOCK and there is not enough 
memory. 

SEE ALSO 
intro(2), shmget(2), shmop(2). 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned; otherwise, a value of -1 is 
returned and errno is set to indicate the error. 


NOTES 
The user must explicitly remove shared memory segments after the last 
reference to them has been removed. 
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NAME 
shmget - get shared memory segment identifier 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


int shmget (key, size, shmfig) 
key t key; 
int size, shmflg; 


DESCRIPTION 
The shmget call returns the shared memory identifier associated with key. 


A shared memory identifier and associated data structure and shared memory 
segment of at least size bytes [see intro(2)] are created for key if one of the 
following are true: 


e key is equal to IPC_PRIVATE. 


e key does not already have a shared memory identifier associated with 
it, and (shmflg & IPC_CREAT) is ‘‘true’’. 
Upon creation, the data structure associated with the new shared memory 
identifier is initialized as follows: 


e shm_perm.cuid, shm_perm.uid, shm_perm.gid, and 
shm_perm.cgid are set equal to the effective user ID and effective 
group ID, respectively, of the calling process. 


e The low-order nine bits of shm_perm.mode are set equal to the low- 
order nine bits of shmflg. shm_segsz is set equal to the value of size. 

e shm_Ipid, shm_nattch, shm_atime, and shm_dtime are set equal 
to zero. 

e shm_ctime is set equal to the current time. 


The shmget call fails if one or more of the following are true: 


[EINVAL] size is less than the system-imposed minimum or greater than 
the system-imposed maximum. 

{EACCES] A shared memory identifier exists for key but operation 
permission [see intro(2)] as specified by the low-order nine 
bits of shmflg would not be granted. 
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[EINVAL] A shared memory identifier exists for key but the size of the 
segment associated with it is less than size and size is not 
equal to zero. 

[ENOENT] A shared memory identifier does not exist for key and 
(shmflg & IPC_CREAT) is ‘‘false’’. 

[ENOSPC] A shared memory identifier is to be created but the system- 


imposed limit on the maximum number of allowed shared 
memory identifiers system wide would be exceeded. 


[ENOMEM] A shared memory identifier and associated shared memory 
segment are to be created but the amount of available 
memory is not sufficient to fill the request. 


[EEXIST] A shared memory identifier exists for key but [(shmflg & 
IPC_CREAT) and (shmflg & IPC_EXCL)] is ‘‘true’’. 


SEE ALSO 
intro(2), shmctl(2), shmop(2). 


DIAGNOSTICS 
Upon successful completion, a non-negative integer, namely a shared memory 
identifier is returned; otherwise, a value of -1 is returned and errno is set to 
indicate the error. 


NOTES 
The user must explicitly remove shared memory segments after the last 
reference to them has been removed. 
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NAME 
shmop - shared memory operations 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


char *shmat (shmid, shmaddr, shmflg) 
int shmid; 

char *shmaddr; 

int shmflg; 


int shmdt (shmaddr) 
char +shmaddr; 


™ 7) 2 eee a 


shmat attaches the shared memory segment associated with the shared memory 
identifier specified by shmid to the data segment of the calling process. The 
segment is attached at the address specified by one of the following criteria: 


e If shmaddr is equal to zero, the segment is attached at the first 
available address as selected by the system. 


e If shmaddr is not equal to zero and (shmflg & SHM_RND) is ‘‘true’’, 
the segment is attached at the address given by [shmaddr - (shmaddr 
modulus SHMLBA)]. 


e If shmadadr is not equal to zero and (shmflg & SHM_RND) is ‘‘false’’, 
the segment is attached at the address given by shmaddr. 


shmdt detaches from the calling process’s data segment the shared memory 
segment located at the address specified by shmaddr. 


The segment is attached for reading if (shmflg & SHM_RDONLY) is ‘‘true’’ 
{READ}, otherwise it is attached for reading and writing {READ/WRITE}. 


shmat will fail and not attach the shared memory segment if one or more of the 
following are true: 


[EINVAL] shmid is not a valid shared memory identifier. 

[EACCES} Operation permission is denied to the calling process [see 
intro (2)]. 

[ENOMEM] The available data space is not large enough to accommodate 
the shared memory segment. 
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[EINVAL] 


[EINVAL] 


[EMFILE] 


[EINVAL] 
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shmadadr is not equal to zero, and the value of [shmaddr - 
(shmaddr modulus SHMLBA)] is an illegal address. 

shmaddr is not equal to zero, (shmflg & SHM_RND) is 
“*false’’, and the value of shmaddr is an illegal address. 


The number of shared memory segments attached to the 
calling process would exceed the system-imposed limit. 


shmdt will fail and not detach the shared memory segment if 
shmadar is not the data segment start address of a shared 
memory segment. 
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NAME 
shutdown - shut down part of a full-duplex connection 
SYNOPSIS 
int shutdown(s, how) 
int s, how; 
DESCRIPTION 
The shutdown call causes all or part of a full-duplex connection on the socket 
associated with s to be shut down. If how is 0, further receives are disallowed. 
If how is 1, further sends are disallowed. If how is 2, further sends and receives 
are disallowed. 
SEE ALSO 
connect(2), socket(2). 
CTIX Network Programmer's Primer. 
DIAGNOSTICS 
A 0 is returned if the call succeeds, -1 if it fails. 
ERRORS 
The call succeeds unless one of the following is true: 


[EBADF] S is not a valid descriptor. 
[ENOTSOCK] S is a file, not a socket. 
[ENOTCONN] The specified socket is not connected. 
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NAME 
signal - specify what to do upon receipt of a signal 


SYNOPSIS 
#include <signal.h> 


void (*signal (sig, func))() 
int sig; 
void (*func)(); 

DESCRIPTION 
signal allows the calling process to choose one of three ways in which it is 
possible to handle the receipt of a specific signal. stg specifies the signal and 
func specifies the choice. 


sig can be assigned any one of the following except SIGKILL: 


SIGHUP 01 hangup 

SIGINT 02 interrupt 

SIGQUIT 030) = quit 

SIGILL 040] illegal instruction (not reset when 
caught) 

SIGTRAP OS! trace trap (not reset when caught) 

SIGIOT O6!!1] JOT instruction 

SIGEMT 071] EMT instruction 

SIGFPE 08] floating point exception 

SIGKILL 09 kill (cannot be caught or ignored) 

SIGBUS 1014) bus error 

SIGSEGV 110] ~~ segmentation violation 

SIGSYS 1211) bad argument to system call 

SIGPIPE 13 write on a pipe with no one to 
read it 


SIGALRM 14 alarm clock 
SIGTERM 15 software termination signal 


SIGUSR1 16 user-defined signal 1 
SIGUSR2 i user-defined signal 2 
SIGCLD 182] death of a child 
SIGPWR 19[2] power fail 


SIG WIND 20 reserved 
SIGPHONE 21 reserved 
SIGPOLL 22/31 selectable event pending 


func is assigned one of three values: SIG_DFL, SIG_IGN, or a function address. 
SIG_DFL, and SIG_IGN, are defined in the include file signal.h. Each is a 
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macro that expands to a constant expression of type pointer to function 
returning void, and has a unique value that matches no declarable function. 


The actions prescribed by the values of func are as follows: 


SIG_DFL - terminate process upon receipt of a signal 
Upon receipt of the signal sig, the receiving process is to be terminated 
with all of the consequences outlined in exit(2). See NOTE [1] below. 


SIG_IGN - ignore signal 
The signal sig is to be ignored. 


Note that the signal SIGKILL cannot be ignored. 


function address - catch signal 
Upon receipt of the signal sig, the receiving process is to execute the 
oinrnal catching funnrtinan nnintad ta hu fiamnr Tha aiamnal numbhar oro 
OLE PIAA WCE EARLE, LUAIVLIVIE prs ws wy J MrsU aS EEW aba BP 1GaL BSULLALWLS Oe 
will be passed as the only argument to the signal-catching function. 
Additional arguments are passed to the signal-catching function for 
hardware-generated signals. Before entering the signal-catching 
function, the value of func for the caught signal will be set to SIG_DFL 


unless the signal is SIGILL, SIGTRAP, or SIGPWR. 


Upon return from the signal-catching function, the receiving process 
will resume execution at the point it was interrupted. 


When a signal that is to be caught occurs during a read(2), a write (2), 
an open(2), or an ioctl(2) system call on a slow device (like a 
terminal; but not a file), during a pause(2) system call, or during a 
wait(2) system call that does not return immediately due to the 
existence of a previously stopped or zombie process, the signal 
catching function will be executed and then the interrupted system call 
may return a -1 to the calling process with errno set to EINTR. 


signal will not catch an invalid function argument, func, and results are 
undefined when an attempt is made to execute the function at the bad 
address. 


Note: The signal SIGKILL cannot be caught. 


A call to signal cancels a pending signal sig except for a pending SIGKILL 
signal. 


signal will fail if sig is an illegal signal number, including SIGKILL. [EINVAL] 
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NOTES 


{1} 


[2] 
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If SIG_DFL is assigned for these signals, in addition to the process 
being terminated, a ‘‘core image’’ will be constructed in the current 
working directory of the process, if the following conditions are met: 


@ The effective user ID and the real user ID of the receiving 
process are equal. 

e An ordinary file named core exists and is writable or can be 
created. If the file must be created, it will have the following 
properties: 


— a mode of 0666 modified by the file creation mask 
[see umask (2)] 


— a file owner ID that is the same as the effective user 
ID of the receiving process. 


—  afile group ID that 1s the same as the effective group 
ID of the receiving process. 


For the signals SIGCLD and SIGPWR func is assigned one of three 
values: SIG_DFL, SIG_IGN, or a function address. The actions 
prescribed by these values are: 


SIG_DFL - ignore signal 
The signal is to be ignored. 


SIG_IGN - ignore signal 
The signal is to be ignored. Also, if sig is SIGCLD, the 
calling process’s child processes will not create zombie 
processes when they terminate [see exit(2)]. 


function address - catch signal 
If the signal is SIGPWR , the action to be taken is the same as 
that described above for func equal to function address. The 
same is true if the signal is SIGCLD with one exception: 
while the process is executing the signal-catching function, 
any received SIGCLD signals will be ignored. (This is the 
default action.) 


In addition, SIGCLD affects the wait, and exit system calls as follows: 


wait If the func value of SIGCLD is set to SIG_IGN and a wait is 
executed, the wait will block until all of the calling process’s 
child processes terminate; it will then return a value of -1 with 
errno set to ECHILD. 
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exit If in the exiting process’s parent process the func value of 
SIGCLD is set to SIG_IGN, the exiting process will not create a 
zombie process. 


When processing a pipeline, the shell makes the last process in the 
pipeline the parent of the proceeding processes. A process that may be 
piped into in this manner (and thus become the parent of other 
processes) should take care not to set SIGCLD to be caught. 


[3] | SIGPOLL is issued when a file descriptor corresponding to a STREAMS 
[see intro(2)] file has a ‘‘selectable’’ event pending. A process must 
specifically request that this signal be sent using the I_SETSIG ioctl call. 
Otherwise, the process will never receive SIGPOLL. 


SEE ALSO 
kili(i), intro(2), kiii(Z), pause(2Z), ptrace(Z), wali(Z), setjmp(3C), sigsei(Z). 
DIAGNOSTICS 
Upon successful completion, signal returns the previous value of func for the 
specified signal sig. Otherwise, a value of SIG_ERR is returned and errno is set 
to indicate the error. SIG_ERR is defined in the include file signal.h. 
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NAME 
sigset, sighold, sigrelse, sigignore, sigpause - signal management 


SYNOPSIS 
#include <signal.h> 


void (*sigset (sig, func))() 
int sig; 
void (*func)(); 
int sighold (sig) 
int sig; 
int sigrelse (sig) 
int sig; 
int sigignore (sig) 
int sig; 
int sigpause (sig) 
int sig; 
DESCRIPTION 
These functions provide signal management for application processes. sigset 
specifies the system signal action to be taken upon receipt of signal sig. This 
action is either calling a process signal-catching handler func or performing a 
system-defined action. 


sig can be assigned any one of the following values except SIGKILL. Machine 
or implementation dependent signals are not included (see NOTES below). Each 
value of sig is a macro, defined in <signal.h>, that expands to an integer 
constant expression. 


SIGHUP _ hangup 

SIGINT interrupt 

SIGQUIT* quit 

SIGILL* __ illegal instruction (not held when caught) 
SIGTRAP* trace trap (not held when caught) 
SIGABRT* abort 

SIGFPE* _ floating point exception 

SIGKILL _ kill (can not be caught or ignored) 
SIGSYS* bad argument to system call 
SIGPIPE __ write on a pipe with no one to read it 
SIGALRM alarm clock 

SIGTERM _ software termination signal 
SIGUSR1 user-defined signal 1 

SIGUSR2 _ user-defined signal 2 
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SIGCLD death of a child (see WARNING below) 
SIGPWR ___ power fail (see WARNING below) 
SIGPOLL _ selectable event pending (see NOTES below) 


See below under SIG_DFL regarding asterisks (*) in the above list. 


The following values for the system-defined actions of func are also defined in 
<signal.h>. Each is a macro that expands to a constant expression of type 
pointer to function returning void and has a unique value that matches no 
declarable function. 


SIG_DFL - default system action 
Upon receipt of the signal sig, the receiving process is to be terminated 
with all of the consequences outlined in exit(2). In addition a “‘core 
image’’ will be made in the current working directory of the receiving 
process if sig ig one for which an asterisk annears in the ahove list and 
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the following conditions are met: 


e The effective user ID and the real user ID of the receiving 
process are equal. 

e An ordinary file named core exists and is writable or can be 
created. If the file must be created, it will have the following 
properties: 


— A mode of 0666 modified by the file creation mask 
[see umask (2)]. 


= A file owner ID that is the same as the effective user 
ID of the receiving process. 


— A file group ID that is the same as the effective 
group ID of the receiving process. 


SIG_IGN - ignore signal 
Any pending signal sig is discarded and the system signal action is set 
to ignore future occurrences of this signal type. 


SIG_HOLD - hold signal 
The signal sig is to be held upon receipt. Any pending signal of this 
type remains held. Only one signal of each type is held. 


Otherwise, func must be a pointer to a function, the signal-catching handler, 
that is to be called when signal sig occurs. In this case, sigset specifies that the 
process will call this function upon receipt of signal sig. Any pending signal of 
this type is released. This handler address is retained across calls to the other 
signal management functions listed here. 
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When a signal occurs, the signal number sig will be passed as the only 
argument to the signal-catching handler. Before calling the signal-catching 
handler, the system signal action will be set to SIG_LHOLD . During normal 
return from the signal-catching handler, the system signal action is restored to 
func and any held signal of this type released. If a non-local goto (longjmp) is 
taken, then sigrelse must be called to restore the system signal action and 
release any held signal of this type. 


In general, upon return from the signal-catching handler, the receiving process 
will resume execution at the point it was interrupted. However, when a signal 
is caught during a read(2), a write(2), an open(2), or an ioctl (2) system call 
during a sigpause system call, or during a wait(2) system call that does not 
return immediately due to the existence of a previously stopped or zombie 
process, the signal-catching handler will be executed and then the interrupted 
system call may return a -1 to the calling process with errno set to EINTR. 


sighold and sigrelse are used to establish critical regions of code. sighold is 
analogous to raising the priority level and deferring or holding a signal until the 
priority is lowered by sigrelse. sigrelse restores the system signal action to that 
specified previously by sigset. 


sigignore sets the action for signal sig to SIG_IGN (see above). 


sigpause suspends the calling process until it receives a signal, the same as 
pause(2). However, if the signal sig had been received and held, it is released 
and the system signal action taken. This system call is useful for testing 
variables that are changed on the occurrence of a signal. The correct usage is to 
use sighold to block the signal first, then test the variables. If they have not 
changed, then call sigpause to wait for the signal. sigset will fail if one or more 
of the following are true: 


[EINVAL] sig is an illegal signal number (including SIGKILL) or the 
default handling of sig cannot be changed. 


[EINTR] A signal was caught during the system call sigpause . 
SEE ALSO 

kill(2), pause(2), signal(2), wait(2), setimp(3C). 
DIAGNOSTICS 


Upon successful completion, sigset returns the previous value of the system 
signal action for the specified signal sig. Otherwise, a value of SIG_ERR is 
returned and errno is set to indicate the error. SIG_ERR is defined in 
<signal.h>. 


For the other functions, upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is retumed and errno is set to indicate the error. 
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NOTES 


SIGPOLL is issued when a file descriptor corresponding to a STREAMS [see 
intro(2)] file has a selectable event pending. A process must specifically 
request that this signal be sent using the I_SETSIG ioct#l(2) call [see 
streamio(7)}. Otherwise, the process will never receive SIGPOLL. 


For portability, applications should use only the symbolic names of signals 
rather than their values and use only the set of signals defined here. The action 
for the signal SIGKILL can not be changed from the default system action. 


Specific implementations may have other implementation-defined signals. 
Also, additional implementation-defined arguments may be passed to the 
signal-catching handler for hardware-generated signals. For certain hardware- 
generated signals, it may not be possible to resume execution at the point of 
interruption. 


The signal type SIGSEGV is reserved for the condition that occurs on an invalid 
access to a data object. If an implementation can detect this condition, this 
signal type should be used. 


The other signal management functions, signal(2) and pause(2), should not be 
used in conjunction with these routines for a particular signal type. 


WARNING 


Two signals that behave differently than the signals described above exist in 
this release of the system: 


SIGCLD death of a child (reset when caught) 
SIGPWR power fail (not reset when caught) 


For these signals, func is assigned one of three values: SIG_DFL, SIG_IGN, or a 
function address. The actions prescribed by these values are as follows: 


SIG_DFL - ignore signal 
The signal is to be ignored. 


SIG_IGN - ignore signal 
The signal is to be ignored. Also, if sig is SIGCLD, the calling process’s 
child processes will not create zombie processes when they terminate 
[see exit(2)]. 


function address - catch signal 
If the signal is SIGPWR, the action to be taken is the same as that 
described above for func equal to function address. The same is true if 
the signal is SIGCLD with one exception: while the process is executing 
the signal-catching function, any received SIGCLD signals will be 
ignored. (This is the default action.) 
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The SIGCLD affects two other system calls [wait(2), and ext(2)} in the 
following ways: 


wait If the func value of SIGCLD 1s set to SIG_IGN and a wait is executed, the 
wait will block until all of the calling process’s child processes terminate; 
it will then return a value of -1 with errno set to ECHILD. 


exit If in the exiting process’s parent process the func value of SIGCLD is set 
to SIG_IGN , the exiting process will not create a zombie process. 


When processing a pipeline, the shell makes the last process in the pipeline the 
parent of the proceeding processes. A process that may be piped into in this 
manner (and thus become the parent of other processes) should take care not to 
set SIGCLD to be caught. 
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NAME 
socket - create an endpoint for communication 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/socket.h> 


s = socket(domain, type, protocol) 
int s, domain, type, protocol; 


DESCRIPTION 
The socket call creates an endpoint for communication and returns a descriptor; 
s is a file descriptor returned by the socket system call. 


The domain parameter specifies a communications domain within which 
communication will take place; this selects the protocol family which should be 
used. The protocol family generally is the same as the address family for the 
addresses supplied in later operations on the socket. These families are defined 
in the include file <sys/socket.h>. The only currently supported format is 
PF_INET (ARPA Internet protocols). 


The socket has the indicated type, which specifies the semantics of 
communication. Currently defined types include: 


SOCK_STREAM 
SOCK_DGRAM 
SOCK_RAW 


Note that not all types are supported by all protocol families. 


A SOCK_STREAM type provides sequenced, reliable, two-way connection- 
based byte streams with an out-of-band data transmission mechanism. A 
SOCK_DGRAM socket supports datagrams (connectionless, unreliable messages 
of a fixed maximum length). 


SOCK_RAW sockets provide access to internal network protocols and 
interfaces. This type is available only to the super-user. 


The protocol specifies a particular protocol to be used with the socket. 
Normally only a single protocol exists to support a particular socket type within 
a given protocol family. However, it is possible that many protocols may exist, 
in which case a particular protocol must be specified in this manner. The 
protocol number to use ts particular to the ‘“communication domain’’ in which 
communication is to take place; see protocols (4). 


Sockets of type SOCK_STREAM are full-duplex byte streams, similar to pipes. 
A stream socket must be in a connected state before any data may be sent or 
received on it. A connection to another socket is created with a connect (2) call. 
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Once connected, data may be transferred using read(2) and write(2) calls or 
some variant of the send(2) and recv(2) calls. When a session has been 
completed a close(2) may be performed. Out-of-band data may also be 
transmitted as described in send(2) and received as described in recv(2). 


The communications protocols used to implement a SOCK_STREAM ensure that 
data is not lost or duplicated. If a piece of data for which the peer protocol has 
buffer space cannot be successfully transmitted within a reasonable length of 
time, then the connection is considered broken and calls will indicate an error 
with -1 returns and with ETIMEDOUT as the specific code in the global variable 
errno. The protocols optionally keep sockets ‘‘warm’’ by forcing transmissions 
roughly every minute in the absence of other activity. An error is then 
indicated if no response can be elicited on an otherwise idle connection for a 
extended period (e.g. 5 minutes). A SIGPIPE signal is raised if a process sends 
on a broken stream; this causes naive processes, which do not handle the signal, 
to exit. 


SOCK_DGRAM and SOCK_RAW sockets allow sending of datagrams to 
correspondents named in send(2) calls. Datagrams are generally received with 
recv(2), which returns the next datagram with its return address. 


An fcntl (2) call can be used to specify a process group to receive a SIGUSR1 
signal when the out-of-band data arrives. 


The operation of sockets is controlled by socket level options. These options 
are defined in the file <sys/socket.h>. setsockopt and getsockopt [see 
getsockopt(2)] are used to set and get options, respectively. The following 
options are recognized at the socket level: 


SO_DEBUG Toggle recording of debugging information. 
SO_REUSEADDR Toggle on/off local address reuse. 

SO_KEEPALIVE Toggle keep connections alive. 

SO_DONTROUTE Toggle routing bypass for outgoing messages. 
SO_LINGER Linger on close if data present. 

SO_BROADCAST Toggle permission to transmit broadcast messages. 
SO_OOBINLINE Toggle reception of out-of-band data in band. 
SO_SNDBUF Set buffer size for output. 

SO_RCVBUF Set buffer size for input. 
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SO_TYPE Get the type of the socket (get only). 
SO_ERROR Get and clear error on the socket (get only). 
The options work as follows: 

SO_DEBUG Enables debugging in the underlying protocol modules. 


SO_REUSEADDR indicates that the rules used in validating addresses supplied 
in a bind(2) call should allow reuse of local addresses. 


SO_KEEPALIVE enables the periodic transmission of messages on a connected 
socket. Should the connected party fail to respond to these messages, the 
connection is considered broken and processes using the socket are notified via 
a SIGPIPE signal. 


SO_DONTROUTE indicates that outgoing messages should bypass the standard 


interface according to the network portion of the destination address. 


SO_LINGER controls the action taken when unsent messags are queued on 
socket and a close(2) is performed. If the socket promises reliable delivery of 
data and SO_LINGER is set, the system blocks the process on the close attempt 
until it 1s able to transmit the data or until it decides it is unable to deliver the 
information (a timeout period, termed the linger interval, is specified in the 
setsockopt call when SO_LINGER is requested). If SO_LINGER is disabled and a 
close is issued, the system processes the close in a manner that allows the 
process to continue as quickly as possible. 


SO_BROADCAST requests permission to send broadcast datagrams on the 
socket. Broadcast was a privileged operation in earlier versions of the system. 


With protocols that support out-of-band data, SOLOOBINLINE requests that 
out-of-band data be placed in the normal data input queue as received; it is then 
accessible with recy or read calls without the MSG_OOB flag. 


SO_SNDBUF and SO_RCVBUF are options to adjust the normal buffer sizes 
allocated for output and input buffers, respectively. The buffer size may be 
increased for high-volume connections, or may be decreased to limit the 
possible backlog of incoming data. The system places an absolute limit on 
these values. 


SO_TYPE and SO_ERROR are options used only with setsockopt. SO_TYPE 
returns the type of the socket, such as SOCK_STREAM; it is useful for servers 
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that inherit sockets on startup. SO_ERROR returns any pending error on the 
socket and clears the error status. It may be used to check for asynchronous 
errors on connected datagram sockets or for other asynchronous errors. 


SEE ALSO 
accept(2), bind(2), connect(2), getsockname(2), getsockopt(2), intro(2), ioctl(2), 
listen(2), read(2), recv(2), select(2), send(2), shutdown(2), write(2), inet(7), 
intro(7). 
CTIX Network Programmer's Primer. 


RETURN VALUE 
A -1 is returned if an error occurs, otherwise the return value is a descriptor 
referencing the socket. 


ERRORS 


[EPROTONOSUPPORT] The protocol type or the specified protocol is not 
supported within this communication domain. 


[EMFILE] The per-process descriptor table is full. 
[ENFILE] The system file table is full. 
[EACCESS] Permission to create a socket of the specified type 


and/or protocol is denied. 


[ENOSR] Insufficient buffer space is available. The socket 
cannot be created until sufficient resources are freed. 
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NAME 
Stat, fstat - get file status 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 


int stat (path, buf) 
char *path; 

struct stat *buf; 

int fstat (fildes, buf) 


int fildes; 
struct stat *buf; 


DESCRIPTION 
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Path points to a path name naming a file. Read, write, or execute permission of 
the named file is not required, but all directories listed in the path name leading 
to the file must be searchable. stat obtains information about the named file. 


Note that in a Remote File Sharing environment, the information returned by 
stat depends upon the user/group mapping set up between the local and remote 
computers. [See idload(1M).] 


fstat obtains information about an open file known by the file descriptor fildes , 
obtained from a successful open, creat, dup, fcntl , or pipe system call. 


buf is a pointer to a stat structure into which information is placed concerning 


the file. 


The contents of the structure pointed to by buf include the following members: 


ushort st_mode; 
ino t— st_ino; 
dev t st_dev; 
dev t st_rdev; 


short = st_nlink; 
ushort st_uid; 
ushort st_gid; 
off_t  st_size; 
time t st_atime; 
time_t st_mtime; 
time t st _ctime; 


/* File mode [see mknod (2)] */ 

/* Inode number */ 

/* 1D of device containing a directory entry for this file */ 
/* ID of device. Defined only for character */ 
/* special or block special files */ 

/* Number of links */ 

/* User ID of the file’s owner */ 

/« Group ID of the file’s group */ 

/* File size in bytes */ 

/x Time of last access */ 

/* Time of last data modification */ 

/« Time of last file status change */ 

/* Times measured in seconds since «/ 

/x 00:00:00 GMT, Jan. 1, 1970 */ 
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st_dev 


st_rdev 


st_nlink 
st uid 
st gid 


st size 


st atime 


st_mtime 


st_ctime 
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The mode of the file as described in the mknod(2) system call. 


This field uniquely identifies the file in a given file system. The 
pair st_ino and st_dev uniquely identifies regular files. 


This field uniquely identifies the file system that contains the 
file. Its value may be used as input to the ustat(2) system call to 
determine more information about this file system. No other 
meaning is associated with this value. 


This field should be used only by administrative commands. It is 
valid only for block special or character special files and only 
has meaning on the system where the file was configured. 


This field should be used only by administrative commands. 
The user ID of the file’s owner. 
The group ID of the file’s group. 


For regular files, this is the address of the end of the file. For 
pipes or fifos, this is the count of the data currently in the file. 
For block special or character special, this is not defined. 


Time when file data was last accessed. Changed by the 
following system calls: creat(2), mknod(2), pipe(2), utime(2), 
and read(2). 


Time when data was last modified. Changed by the following 
system calls: creat(2), mknod(2), pipe(2), utime(2), and 
write (2). 


Time when file status was last changed. Changed by the 
following system calls: chmod(2), chown(2), creat(2), link (2), 
mknod(2), pipe (2), unlink (2), utime (2), and write (2). 


stat will fail if one or more of the following are true: 


[ENOTDIR] 
[ENOENT] 
[EACCES] 


[EFAULT] 
[EINTR] 
[ENOLINK] 


A component of the path prefix is not a directory. 
The named file does not exist. 


Search permission is denied for a component of the path 
prefix. 


buf or path points to an invalid address. 
A signal was caught during the stat system call. 


Path points to a remote machine and the link to that machine 
is no longer active. 
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[EMULTIHOP] Components of path require hopping to multiple remote 
machines. 


fstat will fail if one or more of the following are true: 


[EBADF] fildes is not a valid open file descriptor. 
[EFAULT] buf points to an invalid address. 
{ENOLINK] fildes points to a remote machine and the link to that 


machine is no longer active. 


SEE ALSO 
chmod(2), chown(2), creat(2), link(2), mknod(2), pipe(2), read(2), syslocal(2), 
time(2), unlink(2), utime(2), write(2). 


DIAGNOSTICS 
Upon successful complction a a Valuc oL U is réturied. Oinherwise, a value of -| 1S 
retumed and errno 1s set to indicate the error. 
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NAME 
statfs, fstatfs - get file system information 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/statfs.h> 


int statfs (path, buf, len, fstyp) 
char *path; 

struct statfs *buf; 

int len, fstyp; 


int fstatfs (fildes, buf, len, fstyp) 
int fildes; 

struct statfs *buf; 

int len, fstyp; 


DESCRIPTION 

The statfs call returns a ‘generic super-block’’ describing a file system. It can 
be used to acquire information about mounted as well as unmounted file 
systems, and usage is slightly different in the two cases. In all cases, buf is a 
pointer to a structure (described below) to be filled by the system call, and len 
is the number of bytes of information the system should return in the structure. 
The value of /en must be no greater than sizeof(structstatfs), and ordinarily it 
contains exactly that value; if it holds a smaller value, the system fills the 
structure with that number of bytes. (This allows future versions of the system 
to grow the structure without invalidating older binary programs.) 


If the file system of interest is currently mounted, path should name a file 
which resides on that file system. In this case the file system type is known to 
the operating system and the fstyp argument must be zero. For an unmounted 
file system path must name the block special file containing it and fstyp must 
contain the (non-zero) file system type. In both cases read, write, or execute 
permission of the named file is not required, but all directories listed in the path 
name leading to the file must be searchable. 


The statfs structure pointed to by buf includes the following members: 


short f_fstyp; /* File system type */ 

short f_bsize; /+ Block size */ 

short f_frsize; /+ Fragment size «/ 

long f blocks; /* Total number of blocks +/ 
long _f_bfree; /+ Count of free blocks +/ 

long = f_files; /« Total number of file nodes +/ 
long f_ffree; /* Count of free file nodes +/ 
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f_fname[6]; /* Volume name «/ 
f_ fpack[6]; /* Pack name */ 


The fstatfs call is similar to the sta¢fs call, except that the file named by path in 
statfs is instead identified by an open file descriptor fildes obtained from a 
successful open(2), creat(2), dup(2), fentl(2), or pipe(2) system call. 


The statfs call obsoletes ustat(2) and should be used in preference to it in new 


programs. 


The staifs and fstatfs calls fail if one or more of the following are true: 


[ENOTDIR] 
[ENOENT] 
[EACCES] 


[EFAULT] 


[EBADF] 


[EINVAL] 


[ENOLINK] 


[EMULTIHOP] 


DIAGNOSTICS 


A component of the path prefix is not a directory. 
The named file does not exist. 


Search permission is denied for a component of the path 
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buf or path points to an invalid address. 
fildes is not a valid open file descriptor. 


fstyp is an invalid file system type; path is not a block 
special file and fstyp is nonzero; Jen is negative or is greater 
than sizeof (struct statfs). 


Path points to a remote machine, and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 


Upon successful completion a value of 0 is returned; otherwise, a value of -1 is 
returned and errno is set to indicate the error. 


SEE ALSO 


chmod(2), chown(2), creat(2), link(2), mknod(2), pipe(2), read(2), time(2), 
unlink(2), utime(2), write(2), fs(4). 
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NAME 

stime - set time 
SYNOPSIS 

int stime (tp) 

long *tp; 
DESCRIPTION 


stime sets the system's idea of the time and date. tp points to the value of time 
as measured in seconds from 00:00:00 GMT January 1, 1970. 


[EPERM] stime will fail if the effective user ID of the calling process is 
not super-user. 
SEE ALSO 
time(2). 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


+ hens 


ome am a ee ee te a 


SWRITE(2) SWRITE(2) 


NAME 
Swrite - synchronous write on a file 


SYNOPSIS 
int swrite (fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 


DESCRIPTION 
swrite has the same purpose and conventions as write (2). The two differ solely 
in their handling of disk input/output. swrite, unlike write, does not give a 
normal return before physical output is complete. A program that executes an 
swrite Can assume that the data is on the disk, not waiting in a buffer pool. 


SEE ALSO 
creat(2), dup(2), Iseek(2), open(2), pipe(2), ulimit(2). 
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NAME 
sync - update super block 

SYNOPSIS 
void sync ( ) 

DESCRIPTION 
The sync call causes all information in memory that should be on disk to be 
written oui, including modified super blocks, modified i-nodes, and delayed 
block Y/O. 


The sync call should be used by programs that examine a file system: for 
example fsckand df. A call to sync is mandatory before a reboot. 


The writing, although scheduled, is not necessarily complete upon return from 
sync. 
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NAME 
sysfs - get file system type information 


SYNOPSIS 
#include <sys/fstyp.h> 
#include <sys/fsid.h> 


int sysfs (opcode, fsname) 
int opcode; 
char *fsname; 


int sysfs (opcode, fs_ index, buf) 
int opcode; 
int fs_index; 
char *buf; 
int Sysis (opcode) 
int opcode; 
DESCRIPTION 
sysfs returns information about the file system types configured in the system. 


The number of arguments accepted by sysfs varies and depends on the opcode. 
The currently recognized opcodes and their functions are described below: 


GETFSIND translates fsname, a null-terminated file-system identifier, 
into a file-system type index. 


GETFSTYP translates fs index, a file-system type index, into a null- 
terminated file-system identifier and writes it into the buffer 
pointed to by buf, this buffer must be at least of size 
FSTYPSZ as defined in <sys/fstyp.h>. 


GETNFSTYP returns the total number of file system types configured in 
the system. 


sysfs will fail if one or more of the following are true: 


[EINVAL] fsname points to an invalid file-system identifier; fs index is 
zero, or invalid; opcode is invalid. 
[EFAULT] buf or fsname point to an invalid user address. 
DIAGNOSTICS 


Upon successful completion, sysfs returns the file-system type index if the 
opcode is GETFSIND, a value of 0 if the opcode is GETFSTYP, or the number of 
file system types configured if the opcode is GETNFSTYP. Otherwise, a value 
of -1 is returned and errno is set to indicate the error. 
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NAME 
syslocal - special system requests 


SYNOPSIS 
#include <syslocal.h> 
int syslocal (cmd [ , arg]... ) 
int cmd; 


DESCRIPTION 
The syslocal routine executes certain special system calls. The specific call is 
indicated by the first argument. See the <sys/syslocal.h> file for complete 
documentation of parameters. 


System Type 
Int syslocal(SYSL_SYSTEM) 
Return SYSL_MITI for S/Series. 


Family Member 
int syslocal(SYSL_FAMILYMEMBER) 
Returns a value identifying the specific system: SYSLFMITI1 for S/120, 
§/221-2, or S/320; SYSLFMITI2 for S/480 or S/640; SYSLFS80 for S/80; and 
SYSLFS280 for S/280. 


Superblock Resynchronization 
int syslocai(SYSL_RESYNC, devnum) 
short devnum 
Reread contents of superblock from disk. devnum specifies the file system: the 
high order byte contains the major device number of the character special 
device; the low order byte contains the minor device number. Only the super- 
user can reread the contents of the superblock from disk. 


Maximum Number of Users 
int syslocal(SYSL_MAXUSERS) 
Returns maximum number of users this system is configured for. 


Kernel Addresses 
syslocal(SYSL_KADOR, arg) 
Returns certain addresses of kernel data structures. This allows certain 
programs (ps, Aillall) to run properly, even if /unix is not the currently running 
operating system. 
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arg is one of the following: 


SLA_V Return address of var structure (sys/var.h). 

SLA PROC Return address of proc structure (sys/proc.h). 

SLA_ERR Return address of err structure (sys/err.h). 

SCA_TIME Return address of int time. 

SLA_CDT Return address of crash dump table (CDT) = 
(sys/hardware.h). 


SLA _GDUTAB _ Return address of gdutab (sys/iobuf.h). 
SLA_USRSTK _ Return highest address of user stack. 
SLA_USIGN Return signature of running UNIX (may be compared with 


that of /uniy to see if they are identical). 
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SLA_MEM Return number of bytes of physical memory. 
SLA_BDEVCNT Return the number of slots in struct bdevsw (sys/conf.h). 
SLA_CDEVCNT Return the number of slots in struct cdevsw (sys/conf.h). 
SLA_PRELD Return the address of the preloaded driver table. 


Object Module Type 
syslocal(SYSL_0413MAGIC) 
Returns 1 if the kernel can support the -F option of /dQ. 


Read Real-Time Clock 
syslocal(SYSL_RDRTC, arg) 
Read current state of real-time (battery supported) clock. arg is a pointer to 
struct rtc (sys/rtc.h) 


Write Real-Time Clock 
sysiocal(SYSL_WTRTC, arg) 
Write new state of real-time clock. arg is a pointer to a struct rte (sys/rtc.h). 
EIO is returned if any of the values are illegal. Only the super-user can write 
the real-time clock. 


Reboot System 
syslocal(SYSL_REBOOT) 
Force a software reset. Only the superuser may reset. Obsolete: retained for 
compatibility. Use uadmin (2) instead. 
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Allocate or Bind a Loadable Driver 
sysiocal(SYSL_ALLOCDRV, option, arg) 
sysiocai(SYSL_BINDDRV, option, arg) 
These two functions implement the loadable driver functions of CTIX. They 
both require super-user privilege. 


Loading drivers consists of two phases: allocation of virtual space, device 
numbers, and device IDs; and binding. Fully relocating a driver into memory, 
allocating physical space, plugging the device switch tables, calling 
initialization routines, and unloading require the same two phases in reverse. 
For information on the arguments, see /usr/include/sys/drv.h. 


Determine Processor Type 
syslocal(SYSL_PROCESSOR) 
Returns a value that can be used to determine what kind of processor (68010 or 
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66020) is running and whether floating-point hardware (68881) is available. 
Enable Fixed Priority Range 
syslocal(SYSL_RTNICE, flag) 
Enables/disables the fixed priority range [see nice(2)]. flag is 1 for enable, 2 
for disable. Only the super-user can execute this call, which affects every 
process. 


S/Series Hardware Configuration 
syslocal(SYSL_MITICFIG) 
Returns a bit mask of the hardware that is present. Values can be found in 
syslocal.h. A more convenient way to get this information is by using 
hinv(1M). 
SEE ALSO 
fsck(1M), nice(2). 
DIAGNOSTICS 
Note that syslocal fails if one of the following is true: 


[EINVAL] cmd or any suboption is illegal. 
[EFAULT] An arg points outside the process’s space. 
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NAME 

time - get time 
SYNOPSIS 

#include <sys/types.h> 


time t time (tloc) 
long *tloc; 
DESCRIPTION 


The time call returns the value of time in seconds since 00:00:00 GMT, January 
1, 1970. 


If tloc is non-zero, the return value is also stored in the location to which tloc 
points. 


foc points to an illegai address. 


DIAGNOSTICS 
Upon successful completion, time returns the value of time; otherwise, a value 
of -1 is returned and errno is set to indicate the error. 
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NAME 
times - get process and child process times 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/times.h> 


long times (buffer) 
struct tms *buffer; 


DESCRIPTION 
The times call fills the structure pointed to by buffer with time-accounting 
information. The following are the contents of this structure: 


struct tms{ 
time _t tms_utime; 
time t tms_stime; 
time t tms_cutime; 
time_t tms_cstime; 


} 


This information comes from the calling process and each of its terminated 
child processes for which it has executed a wait. All times are reported in clock 
ticks per second. Clock ticks are a system-dependent parameter. The specific 
value for an implementation is defined by the variable HZ, found in the include 
file param.h. 


ims_utime 
Is the CPU time used while executing instructions in the user space of 
the calling process. 


tms_Stime 
Is the CPU time used by the system on behalf of the calling process. 


tms_cutime 
Is the sum of the tms_utimes and tms_cutimes of the child processes. 


tms_cstime 
Is the sum of the tms_stimes and tms_cstimes of the child processes. 


The times call fails if the following is true: 
[EFAULT] buffer points to an illegal address. 


SEE ALSO 
exec(2), fork(2), time(2), wait(2). 
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DIAGNOSTICS 


Upon successful completion, times returns the elapsed real time, in clock ticks 
per second, from an arbitrary point in the past (such as system start-up time). 
This point does not change from one invocation of times to another. If times 
fails, a -1 is returned and errno is set to indicate the error. 
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NAME 
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uadmin - administrative control 


SYNOPSIS 


#include <sys/uadmin.h> 


int uadmin (cmd, fcn, mdep) 


int cmd, fcn, mdep; 


DESCRIPTION 


Uadmin provides control for basic administrative functions. This system call is 
tightly coupled to the system administrative procedures and is not intended for 
general use. The mdep argument is provided for machine-dependent use and is 


not defined here. 


As specified by cmd, the following commands are available: 


A_SHUTDOWN 


A_REBOOT 


Shut down the system. All user processes are killed, the 
buffer cache is flushed, and the root file system is 
unmounted. The fcn function specifies the action to be 
taken after the system is shut down. The functions are 
generic; the hardware capabilities vary on specific 
machines. 


AD_HALT Halt the processor so it is safe to turn off 
the power. 


AD_BOOT Reboot the system. 


Reboot the system immediately, without further processing. 


A_REMOUNT 


The root file system is mounted again after having been fixed. This 
should be used only during the startup process. 


A_HALT 


The system stops immediately. 


uadmin fails if any of the following are true: 


[EPERM] 


SEE ALSO 
syslocal(2). 


The effective user ID is not super-user. 
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DIAGNOSTICS 
Upon successful completion, the value returned depends on cmd as follows: 


A_SHUTDOWN Never returns. 


A_REBOOT Never returns. 
A_REMOUNT 0 
A_HALT Never returns. 


Otherwise, a value of -1 is returned and errno is set to indicate the error. 
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NAME 
ulimit - get and set user limits 


SYNOPSIS 
long ulimit (cmd, newlimit) 
int cmd; 
long newlimit; 
DESCRIPTION 
This function provides for control over process limits. The cmd values follow: 
1 Get the regular file size limit of the process. The limit is in units of 512- 
byte blocks and is inherited by child processes. Files of any size can be 
read. 


Z Set the regular file size limit of the process to the value of newlimit. Any 
process may decrease this limit, but Only a process with an effective user 
YD of super-user may increase the limit. ulimit fails and the limit is 
unchanged if a process with an effective user ID other than super-user 
attempts to increase its regular file size limit. [EPERM] 


Get the maximum possible break value [see brk(2)]. 


Get the current value of the maximum number of open files per process 
configured in the system. 


SEE ALSO 
brk(2), write(2). 

DIAGNOSTICS 
Upon successful completion, a non-negative value is returned; otherwise, a 
value of -1 is returned and errno is set to indicate the error. 

WARNING 


The ulimit call is effective in limiting the growth of regular files. Pipes are 
currently limited to 9,216 bytes (this is the maximum atomic write size). 
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NAME 
umask - set and get file creation mask 


SYNOPSIS 
int umask (cmask) 
int cmask; 

DESCRIPTION 
The umask cali sets the process’s file mode creation mask to cmask and returns 
the previous value of the mask. Only the low-order 9 bits of cmask and the file 
mode creation mask are used. 


SEE ALSO 
mkdir(1), sh(1), chmod(2), creat(2), mknod(2), open(2). 
DIAGNOSTICS 
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NAME 


UMOUNT (2) 


umount - unmount a file system 


SYNOPSIS 


int umount (file) 


char *file; 
DESCRIPTION 


The umount call requests that a previously mounted file system contained on 
the block special device or directory identified by file be unmounted. The file 
parameter is a pointer to a path name. After unmounting the file system, the 
directory upon which the file system was mounted reverts to its ordinary 


interpretation. 


The umount call can be invoked only by the super-user. 


The umouni Cail faiis if one or more of the foliowing are true: 


[EPERM] 
[EINVAL] 
[ENOTBLK] 
[EINVAL] 
[EBUSY] 
[EFAULT] 
[EREMOTE] 
[ENOLINK] 


[EMULTIHOP] 
SEE ALSO 


mount(2). 
DIAGNOSTICS 


The process’s effective user ID is not super-user. 
file does not exist. 

file is not a block special device. 

file is not mounted. 

A file on file is busy. 

file points to an illegal address. 

file is remote. 


file is on a remote machine, and the link to that machine is no 
longer active. 


Components of the path pointed to by file require hopping to 
multiple remote machines. 


Upon successful completion a value of 0 is returned; otherwise, a value of -1 is 
returned and errno ts set to indicate the error. 
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NAME 
uname - get name of current CTIX system 


SYNOPSIS 
#include <sys/utsname.h> 


int uname (name) 
Struct utsname *name; 


DESCRIPTION 
The uname call stores information identifying the current CTIX system in the 
structure pointed to by name. 


The call uses the structure defined in <sys/utsname.h>, whose members follow: 


char sysname{9]; 
char nodename]9}; 
char release[9]; 
char version{[9]; 


char machine{9]; 


The uname call returns a null-terminated character string naming the current 
CTIX system in the character array sysname. Similarly, nodename contains the 
name that the system is known by on a communications network. [Note the 
equivalence of nodename and the left-most qualifier in a full Internet name; see 
hostname (1).) The release and version members further identify the operating 
system; machine contains a standard name that identifies the hardware that the 
CTIX system is running on. 


[EFAULT] uname fails if name points to an invalid address. 
SEE ALSO 

hostname(1), setuname(1M), uname(1), sethostname (2). 
DIAGNOSTICS 


Upon successful completion, a non-negative value is returned; otherwise, a 
value of -1 is returned and errno is set to indicate the error. 
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NAME 
unlink - remove directory entry 


SYNOPSIS 
int unlink (path) 
char *path; 


DESCRIPTION 


unlink removes the directory entry named by the path name pointed to by path. 


The named file is unlinked unless one or more of the following are true: 


[ENOTDIR] 


[ENOENT] 
[EACCES] 


[EACCES] 


[EACCES] 


{EPERM] 


[EBUSY] 


(ETXTBS Y] 


[EROFS] 


[EFAULT] 
[EINTR] 
[ENOLINK] 


{[EMULTIHOP] 


A component of the path prefix is not a directory. 
The named file does not exist. 


Search permission is denied for a component of the path 
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Write permission is denied on the directory containing the 
link to be removed. 


The parent directory has the sticky bit set and: the parent 
directory is not owned by the user; and the directory is not 
owned by the user; and the directory is not writable by the 
user; and the user is not super-user. 


The named file is a directory and the effective user ID of the 
process is not super-user. 


The entry to be unlinked is the mount point for a mounted 
file system. 


The entry to be unlinked is the last link to a pure procedure 
(shared text) file that is being executed. 


The directory entry to be unlinked is part of a read-only file 
system. 


Path points outside the process’s allocated address space. 
A signal was caught during the unlink system call. 


Path points to a remote machine and the link to that machine 
is no longer active. 


Components of path require hopping to multiple remote 
machines. 


When all links to a file have been removed and no process has the file open, the 
space occupied by the file is freed and the file ceases to exist. If one or more 
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processes have the file open when the last link is removed, the removal is 
postponed until all references to the file have been closed. 


SEE ALSO 
rm(1), close(2), link(2), open(?2). 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 
ustat - get file system statistics 


SYNOPSIS 
#include <sys/types.h> 
#include <ustat.h> 


int ustat (dev, buf) 
dev t dev; 
struct ustat *buf; 


DESCRIPTION 
The ustat call returns information about a mounted file system. dev is a device 
number identifying a device containing a mounted file system. buf is a pointer 
to a ustat structure that includes the following elements: 


daddr t__—‘f_tfree; /+ Total free blocks +/ 

ino t f_tinode; /* Number of free inodes +/ 
char f_fname[6]; /* Filsys name «/ 

char f_ fpack[6]; | /+ Filsys pack name +/ 


The ustat call fails if one or more of the following are true: 


[EINVAL] dev is not the device number of a device containing a 
mounted file system. 
[EFAULT] buf points outside the process’s allocated address space. 
{EINTR] A signal was caught during a ustat system call. 
(ENOLINK] dev is on a remote machine and the link to that machine is no 
longer active. 
[ECOMM] dev is on a remote machine and the link to that machine is no 
longer active. 
SEE ALSO 
Sstat(2), statfs(2), fs(4). 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


NOTE 
The statfs call obsoletes ustat(2) and should be used in preference to ustat(2) in 
new programs. 
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NAME 
utime - set file access and modification times 


SYNOPSIS 
#include <sys/types.h> 
int utime (path, times) 
char *path; 
struct utimbuf *times; 


DESCRIPTION 
The path parameter points to a path name naming a file. The utime call sets the 
access and modification times of the named file. 


If times is NULL, the access and modification times of the file are set to the 
current time. A process must be the owner of the file or have write permission 
to use utime in this manner. 


If times is not NULL, times is interpreted as a pointer to a utimbuf structure and 
the access and modification times are set to the values contained in the 
designated structure. Only the owner of the file or the super-user can use utime 
this way. 


The times in the following structure are measured in seconds since 00:00:00 
GMT, Jan. 1, 1970. 


struct utimbuf { 


time t actime; /* access time */ 
time t modtime; /* modification time */ 
}; 
The utime call fails if one or more of the following are true: 
f[ENOENT] The named file does not exist. 
[ENOTDIR} A component of the path prefix is not a directory. 
[EACCES] Search permission is denied by a component of the path 
prefix. 
[EPERM] The effective user ID is not super-user and not the owner of 
the file and times is not NULL. 
[EACCES] The effective user ID is not super-user and not the owner of 
the file and times is NULL and write access is denied. 
[EROFS] The file system containing the file is mounted read-only. 
[EFAULT] times is not NULL and points outside the process’s allocated 


address space. 
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{EFAULT} path points outside the process’s allocated address space. 
[EINTR] A signal was caught during the utime system call. 
[ENOLINK] path points to a remote machine and the link to that machine 
is no longer active. 
(EMULTIHOP] Components of path require hopping to multiple remote 
machines. 
SEE ALSO 
stat(2). 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned; otherwise, a value of -1 is 
retumed and errno is set to indicate the error. 
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NAME 
wait - wait for child process to stop or terminate 


SYNOPSIS 
int wait (stat_loc) 
int *stat_loc; 


DESCRIPTION 

The wait call suspends the calling process until until one of the immediate 
Children terminates or unul a child that is being traced stops, because it has hit a 
break point. The wait system call returns prematurely if a signal is received and 
if a child process stopped or terminated prior to the call on wait, return is 
immediate. 

If stat_loc is non-zero, 16 bits of information called status are stored in the 
low-order 16 bits of the location pointed to by stat_loc. sidiuy can be used to 
differentiate between stopped and terminated child processes and if the child 
process terminated, status identifies the cause of termination and passes useful 
information to the parent. This is accomplished in the following manner: 


e If the child process stopped, the high-order 8 bits of status contain the 
number of the signal that caused the process to stop and the low-order 
8 bits are set equal to 0177. 


@ If the child process terminated due to an exit call, the low-order 8 bits 
of status are zero and the high-order 8 bits contain the low-order 8 bits 
of the argument that the child process passed to exit (see exit (2)]. 


e If the child process terminated due to a signal, the high-order 8 bits of 
Status are zero and the low-order 8 bits contain the number of the 
signal that caused the termination. In addition, if the low-order seventh 
bit (bit 200) is set, a “‘core image’’ will have been produced [see 
signal (2)]. 


If a parent process terminates without waiting for its child processes to 
terminate, the parent process ID of each child process is set to 1. This means the 
initialization process inherits the child processes [see intro(2)). 


The wait call fails and returns immediately if the following is true: 


[ECHILD] The calling process has no existing unwaited-for child 
processes. 


SEE ALSO 
exec(2), exit(2), fork(2), intro(2), pause(2), ptrace(2), signal(2). 
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DIAGNOSTICS 
If wait returns due to the receipt of a signal, a value of -1 1s returned to the 
calling process and errno is set to EINTR. If wait returns due to a stopped or 
terminated child process, the process ID of the child is returned to the calling 
process; otherwise, a value of -1 is returned and errno is set to indicate the 
error. 


WARNING 
The wait call fails and its actions are undefined if stat_loc points to an invalid 
address. 


See WARNING in signal (2). 
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NAME 


write - write on a file 


SYNOPSIS 


int write (fildes, buf, nbyte) 
int fildes; 

char *buf; 

unsigned nbyte; 


DESCRIPTION 


The fildes argument is a file descriptor obtained from a creat(2), open(2), 
dup(2), fentl (2), or pipe (2) system call. 


The write call attempts to write nbyte bytes from the buffer pointed to by buf to 
the file associated with the fildes. 

On devices capabie of seeking, the actual writing of data proceeds from the 
position in the file indicated by the file pointer. Upon return from write , the file 
pointer is incremented by the number of bytes actually written. 


On devices incapable of seeking, writing always takes place starting at the 
Current position. The value of a file pointer associated with such a device is 
undefined. 


If the O_APPEND flag of the file status flags is set, the file pointer will be set to 
the end of the file prior to each write. 


For regular files, if the O_SYNC flag of the file status flags is set, the write will 
not return until both the file data and file status have been physically updated. 
This function is for special applications that require extra reliability at the cost 
of performance. For block special files, if O_LSYNC is set, the write will not 
return until the data has been physically updated. 


A write to a regular file will be blocked if mandatory file/record locking is set 
[see chmod(2)], and there is a record lock owned by another process on the 
segment of the file to be written. If O_NDELAY is not set, the write sleeps until 
the blocking record lock is removed. 


For STREAMS [see intro(2)} files, the operation of write is determined by the 
values of the minimum and maximum nbyte range (packet size) accepted by the 
stream. These values are contained in the topmost stream module. Unless the 
user pushes [see I_PUSH in streamio(7)] the topmost module, these values can 
not be set or tested from user level. If nbyte falls within the packet size range, 
nbyte bytes will be written. If nbyte does not fall within the range and the 
minimum packet size value is zero, write will break the buffer into maximum 
packet size segments prior to sending the data downstream (the last segment 
may contain less than the maximum packet size). If mbyte does not fall within 
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the range and the minimum value is non-zero, write will fail with errno set to 
ERANGE. Writing a zero-length buffer (nbyte is zero) sends zero bytes with 
zero returned. 


For STREAMS files, if O_NDELAY is not set and the stream can not accept data 
(the stream write queue is full due to internal flow control conditions), write 
will block until data can be accepted. O_NDELAY will prevent a process from 
biocking due to flow control conditions. If O_NDELAY is set and the stream 
can not accept data, write will fail. If O_NDELAY is set and part of the buffer 
has been written when a condition in which the stream can not accept 
additional data occurs, write will terminate and return the number of bytes 


written. 


write will fail and the file pointer will remain unchanged if one or more of the 
following are true: 


[EAGAIN] Mandatory file/record locking was set, O_NDELAY was set, 
and there was a blocking record lock. 

[EAGAIN] Total amount of system memory available when reading via 
raw I/O is temporarily insufficient. 

[EAGAIN] Attempt to write to a stream that can not accept data with the 
O_NDELAY flag set. 

[EBADF] fildes is not a valid file descriptor open for writing. 

[EDEADLK] The write was going to go to sleep and cause a deadlock 
situation to occur. 

{[EFAULT] buf points outside the process’s allocated address space. 

[EFBIG] An attempt was made to write a file that exceeds the 
process’s file size limit or the maximum file size [see 
ulimit (2)}. 

(EINTR] A signal was caught during the wrife system call. 

[EINVAL] Attempt to write to a stream linked below a multiplexor. 

[ENOLCK] The system record lock table was full, so the write could not 
go to sleep until the blocking record lock was removed. 

[ENOLINK] fildes is on a remote machine and the link to that machine is 
no longer active. 

[ENOSPC] During a write to an ordinary file, there is no free space left 


on the device. 
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[ENXIO] A hangup occurred on the stream being written to. 


(EPIPE and SIGPIPE signal] 
An attempt is made to write to a pipe that is not open for 
reading by any process. 


[ERANGE] Attempt to write to a stream with nbyte outside specified 
minimum and maximum write range, and the minimum value 
is Non-zero. 

[EDEADLOCK] _ A side effect of the locking(2) call. (See the WARNING on 
the locking (2) manpage.) 


If a write requests that more bytes be written than there is room for (e.g., the 
ulimit [see ulimit(2)] or the physical end of a medium), only as many bytes as 
there is room for will be written. For example, suppose there is space for 20 
bytes more in a file before reaching a limit. A wriie of 5i12Z-bytes will return 20. 
The next write of a non-zero number of bytes will give a failure return (except 
as noted below). 


If the file being written is a pipe (or FIFO) and the O_NDELAY flag of the file 
flag word is set, then write to a full pipe (or FIFO) will return a count of 0. 
Otherwise (O_NDELAY clear), writes to a full pipe (or FIFO) will block until 
space becomes available. 


A write to a STREAMS file can fail if an error message has been received at the 
Stream head. In this case, errno is set to the value included in the error 
message. 


SEE ALSO 
creat(2), dup(2), fentl(2), intro(2), Iseek(2), open(2), pipe(2), ulimit(2). 


DIAGNOSTICS 
Upon successful completion the number of bytes actually written is returned. 
Otherwise, -1 is returned and errno is set to indicate the error. 
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intro - introduction to functions and libraries 


DESCRIPTION 


This section describes functions found in various libraries, other than those 
functions that directly invoke CTIX system primitives, which are described in 
Section 2 of this volume. Certain major collections are identified by a letter 
after the section number: 


(3C) 


(3S) 


(3M) 


(3N) 


(3X) 


These functions, together with those of Section 2 and those marked (3S), 
constitute the Standard C Library libc, which is automatically loaded by 
the C compiler, cc(1). The link editor /d(1) searches this library under 
the -le option. A ‘‘shared library’’ version of libc can be searched using 
the -lc_s option, resulting in smaller a.outs. Declarations for some of 
these functions may be obtained from #include files indicated on the 
appropmaie pages. 


These functions constitute the ‘‘standard VO package’’ [see stdio(3S)). 
These functions are in the library libc , already mentioned. Declarations 
for these functions may be obtained from the #include file <stdio.h>. 


These functions constitute the Math Library, libm. They are not 
automatically loaded by the C compiler, cc(1); however, the link editor 
searches this library under the -lm option. Declarations for these 
functions may be obtained from the #include file <math.h>. Several 
generally useful mathematical constants are also defined there [see 
math(5)}. 


This contains sets of functions constituting the Network Services 
library. These sets provide protocol-independent interfaces to 
networking services based on the service definitions of the OSI (Open 
Systems Interconnection) reference model. Application developers 
access the function sets that provide services at a particular level. 


This library contains the functions of the TRANSPORT INTERFACE (TI) 
- provide the services of the OSI Transport Layer. These services 
provide reliable end-to-end data transmission using the services of an 
underlying network. Applications written using the TI functions are 
independent of the underlying protocols. Declarations for these 
functions may be obtained from the #include file <tiuser.h>. The link 
editor /d(1) searches this library under the -Insl_s option. 


Various specialized libraries. The files in which these libraries are 
found are given on the appropriate pages. 
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DEFINITIONS 

A character is any bit pattern able to fit into a byte on the machine. The null 
character is a character with value 0, represented in the C language as ‘\0’. A 
character array is a sequence of characters. A null-terminated character array 
is a sequence of characters, the last of which is the null character. A String is a 
designation for a null-terminated character array. The null string is a character 
array containing only the null character. A NULL pointer is the value that is 
obtained by casting 0 into a pointer. The C language guarantees that this value 
will not match that of any legitimate pointer, so many functions that return 
pointers return it to indicate an error. NULL is defined as 0 in <stdio.h>; the 
user can include an appropriate definition if not using <stdio.h>. 


Netbuf 
In the Network Services library, netbuf is a structure used in various Transport 
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the following members: 


unsigned int maxien; 
unsigned int len; 
char *buf; 


buf points to a user input and/or output buffer. len generally specifies the 
number of bytes contained in the buffer. If the structure is used for both input 
and output, the function will replace the user value of len on return. 


maxlen generally has significance only when buf is used to receive output from 
the TI function. In this case, it specifies the physical size of the buffer, the 
maximum value of Jen that can be set by the function. If maxlen is not large 
enough to hold the returned information, an TBUFOVFLW error will generally 
result. However, certain functions may return part of the data and not generate 
an error. 


Note that a struct sockaddr goes in all ‘‘addr’’ TLI netbufs. 
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FILES 


/lib 

/lib/libc.a 
/lib/libc_s.a 
/lib/libm.a 
/shlib/libclsw_s 
/shlib/libc2sw_s 
/shlib/libc2fp_s 
/shlib/libnsllsw_s 
/shlib/libnsl2sw_s 
/shlib/libnsl2fp_s 
/usr/lib/libnsl_s.a 


SEE ALSO 
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DIAGNOSTICS 


Functions in the C and Math Libraries (3C and 3M) may return the 
conventional values 0 or +HUGE (the largest-magnitude single-precision 
floating-point numbers; HUGE is defined in the <math.h> header file) when 
the function is undefined for the given arguments or when the value is not 
representable. In these cases, the external variable errno [see intro(2)] is set to 
the value EDOM or ERANGE. 


WARNING 


Many of the functions in the libraries call and/or refer to other functions and 
external variables described in this section and in Section 2 (System Calls). Ifa 
program inadvertently defines a function or external variable with the same 
name, the presumed library version of the function or external variable may not 
be loaded. The /int(1) program checker reports name conflicts of this kind as 
‘‘multiple declarations’’ of the names in question. Definitions for Sections 2, 
3C, and 3S are checked automatically. Other definitions can be included by 
using the -] option. (For example, -lm includes definitions for Section 3M, the 
Math Library.) Use of lint is highly recommended. 
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NAME 
a641, 164a - convert between long integer and base-64 ASCTI string 


SYNOPSIS 
long a64I (s) 
char *s; 
char *164a (I) 
iong |; 
DESCRIPTION 
These functions are used to maintain numbers stored in base-64 ASCII 


characters. This is a notation by which long integers can be represented by up 
to six characters; each character represents a ‘‘digit’’ in a radix-64 notation. 


The characters used to represent “‘digits’’ are . for 0, / for 1, 0 through 9 for 
2-11, A through Z for 12-37, and a through z for 38-63. 

a64l takes a pointer to a null-terminated base-64 representation and returns a 
corresponding long value. If the string pointed to by s contains more than six 
characters, a64l will use the first six. 


a64l scans the character string from left to right, decoding each character as a 6 
bit Radix 64 number. 


l64a takes a long argument and returns a pointer to the corresponding base-64 
representation. If the argument is 0, /64a returns a pointer to a null string. 


CAVEAT 
The value returned by /64a is a pointer into a static buffer, the contents of 
which are overwritten by each call. 
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NAME 
abort - generate a SIGABRT 


SYNOPSIS 
int abort ( ) 


DESCRIPTION 
The abort routine does the work of exit(2), but instead of just exiting, abort 
causes SIGABRT to be sent to the calling process. If SIGABRT is neither caught 
nor ignored, all stdio(3S) streams are flushed prior to the signal being sent, and 
a core dump results. 


The abort routine returns the value of the kil] (2) system call. 
SEE ALSO 
sdb(1), exit(2), kill(2), signai(2). 


DIAGNOSTICS 
If SIGABRT is neither caught nor ignored, and the current directory is writable, 
a core dump is produced and the message ‘‘abort - core dumped’’ is written by 
the shell. 
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NAME 
abs - return integer absolute value 


SYNOPSIS 
int abs (i) 
int i; 
DESCRIPTION 
The abs routine returns the absolute value of its integer operand. 


SEE ALSO 
floor(3M). 


CAVEAT 
In two’s-complement representation, the absolute value of the negative integer 
with largest magnitude is undefined. Some implementations trap this error, but 
others simply ignore it. 
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NAME 
assert - verify program assertion 


SYNOPSIS 
#include <assert.h> 


assert (expression) 
int expression; 


DESCRIPTION 
This macro is useful for putting diagnostics into programs. When it is executed, 
if expression is false (zero), assert prints 


Assertion failed: expression, file xyz, line nnn 


on the standard error output and aborts. In the error message, xyz is the name of 
the source file and nnn the source line number of the assert statement. 


Compiling with the preprocessor option -DNDEBUG [see cpp (1)], or with the 
preprocessor control statement #define NDEBUG ahead of the #include 
<assert.h> statement, will stop assertions from being compiled into the 
program. 

SEE ALSO 
cpp(1), abort(3C). 

CAVEAT 


Since assert is implemented as a macro, the expression may not contain any 
String literals. 
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NAME 
bessel: j0, j1, jn, yO, yl, yn - Bessel functions 


SYNOPSIS 
#include <math.h> 


double j0 (x) 
double x; 


double ji (x) 
double x; 


double jn (n, x) 
int n; 

double x; 
double yO (x) 
double x; 


double yl (x) 
double x; 


double yn (n, x) 

int n; 

double x; 
DESCRIPTION 


jO and j/ return Bessel functions of x of the first kind of orders 0 and 1, 
respectively. jn returns the Bessel function of x of the first kind of order n. 


yO and y/ return Bessel functions of x of the second kind of orders 0 and 1, 
respectively. yn returns the Bessel function of x of the second kind of order n. 
The value of x must be positive. 


SEE ALSO 
matherr(3M). 


DIAGNOSTICS 
Non-positive arguments cause y0, y/ and yn to return the value -HUGE and to 
set errno to EDOM. In addition, a message indicating DOMAIN error is printed 
on the standard error output. 


Arguments too large in magnitude cause j0,j/, yO and y/ to return zero and to 
set errno to ERANGE. In addition, a message indicating TLOSS error is printed 
on the standard error output. 


These error-handling procedures can be changed with the function 
matherr (3M). 
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NAME 
bsearch - binary search a sorted table 

SYNOPSIS 
#include <search.h> 
char *bsearch ((char *) key, (char *) base, nel, sizeof (*key), compar) 
unsigned nel; 
int (*compar)( ); 

DESCRIPTION 
The bsearch routine is a binary search routine generalized from Knuth (6.2.1) 
Algorithm B. It returns a pointer into a table indicating where a datum can be 
found. The table must be previously sorted in increasing order according to a 
provided comparison function. key points to a datum instance to be sought in 
the table. Base points to the element at the base of the table. vel is the number 
of elements in the table. compar is the name of the comparison function, which 
is called with two arguments that point to the elements being compared. The 
function must return an integer less than, equal to, or greater than zero as 
accordingly the first argument is to be considered less than, equal to, or greater 
than the second. 

EXAMPLE 


The example below searches a table containing pointers to nodes consisting of a 
string and its length. The table is ordered alphabetically on the string in the 
node pointed to by each entry. 


This code fragment reads in strings and either finds the corresponding node and 
prints the string and its length, or prints an error message. 


#include <stdio.h> 
#include <search.h> 


#define TABSIZE 1000 

struct node { /* these are stored in the table +/ 
char «string; 
int length; 


iB 
struct node table[TABSIZE]; /* table to be searched +/ 
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NOTES 


struct node «node _ptr, node; 
int node_compare(); /* routine to compare 2 nodes */ 
char str_space[20]; /* space to read string into */ 


node.string = str_space; 
while (scanf("%s", node.string) != EOF) { 
node_ptr = (struct node +)bsearch((char +) 
(&node), (char +)table, TABSIZE, 
sizeof (struct node), node_compare); 
if (node_ptr != NULL) { 
(void)printf("string = %20s. 
length = %d\n", node_ptr->string, 
node _ptr->length); 
} else { 
(void)printf ("not found: %s\n", 
node.string); 


| ) 
/+ This routine compares two nodes based on an | 
alphabetical ordering of the string field. «/ | 
int 
node_compare(node1, node2) 
char *node1, +node2; 
{ 
return (strcemp( 


((struct node «)nodet)->string, 
((struct node +)node2)->string)); 


The pointers to the key and the element at the base of the table should be of 
type pointer-to-element, and cast to type pointer-to-character. 


The comparison function need not compare every byte, so arbitrary data may be 
contained in the elements in addition to the values being compared. 


Although bsearch is declared as type pointer-to-character, the value returned 
should be cast into type pointer-to-element. 
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SEE ALSO 
hsearch(3C), Isearch(3C), qsort(3C), tsearch(3C). 


DIAGNOSTICS 
A NULL pointer is returned if the key cannot be found in the table. 


fe new ete 


on 


BSTRING(3) BSTRING(3) 


NAME 
bcopy, bcmp, bzero - bit and byte string operations 


SYNOPSIS 
int bcopy(src, dst, length) 
char *src, *dst; 
int length; 
int bemp(b1, b2, length) 
char *bl, *b2; 
int length; 
int bzero(b, length) 
char *b; 
int length; 
DESCRIFIION 
The functions bcopy, bemp, and bzero operate on variable length strings of 
bytes. They do not check for null bytes as the routines in string (3) do. 


The bcopy routine copies length bytes from string src to the string dst. 


The bcmp routine compares byte string b/ against byte string b2, returning zero 
if they are identical, non-zero otherwise. Both strings are assumed to be length 
bytes long. 


bzero places length 0 bytes in the string b!. 


WARNING 
The bcopy routine take parameters backwards from strcpy. 


ee 
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NAME 
htonl, htons, ntohl, ntohs - convert values between host and network byte order 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/in.h> 


netlong = htonl(hostlong); 
unsigned jong netiong, hostlong; 


netshort = htons(hostshort); 
ushort netshort, hostshort; 


hostlong = ntohl(netlong); 
unsigned long hostlong, netlong; 


hostshort = ntohs(netshort); 
ushort hostshort, netshort; 


DESCRIPTION 
These routines convert 16- and 32-bit quantities between network byte order 
and host byte order. These routines are defined as null macros in the include file 
<sys/in.h> (that 1s, network byte order 1s native 680x0 order). 


These routines are most often used in conjunction with Internet addresses and 
ports as returned by gethostent(3) and getservent (3). 


SEE ALSO 
gethostbyname(3), getservent(3). 
CTIX Network Programmer's Primer. 
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NAME 


clock - report CPU time used 


SYNOPSIS 


jong clock ( ) 


DESCRIPTION 


The clock routine returns the amount of CPU time (in microseconds) used since 
the first call to clock. The time reported is the sum of the user and system times 
of the calling process and its terminated child processes for which it has 
executed wait(2), pclose (3S), or system(3S). 


The resolution of the clock is 1/HZ seconds on CTIX processors (HZ is defined 
in <sys/param.h>). 


SEE ALSO 


BUGS 


The value returned by clock is defined in microseconds for compatibility with 
systems that have CPU clocks with much higher resolution. Because of this, the 
value returned wraps around after accumulating only 2147 seconds of CPU time 
(about 36 minutes). The value then accumulates to -2148 and finally wrap 
around again to 0. 
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NAME 


conv: toupper, tolower, _toupper, _tolower, toascii - translate characters 


SYNOPSIS 


#include <ctype.h> 


int toupper (c) 
int ¢; 

int tolower (c) 
int c; 

int toupper (c) 
int ¢c; 

int tolower (c) 
int ¢; 

int toascii (c) 
int ¢c; 


DESCRIPTION 


The toupper and tolower routines have as domain the range of getc(3S): the 
integers from -1 through 255. If the argument of toupper represents a 
lowercase letter, the result is the corresponding uppercase letter. If the 
argument of tolower represents an uppercase letter, the result is the 
corresponding lower-case letter. All other arguments in the domain are 
returned unchanged. 


The macros toupper and _tolower, accomplish the same thing as toupper and 
tolower but have restricted domains and are faster. toupper requires a 
lowercase letter as its argument; its result is the corresponding uppercase letter. 
The macro _tolower requires an uppercase letter as its argument; its result is the 
corresponding lower-case letter. Arguments outside the domain cause 
undefined results. 


The toascii routine yields its argument with all bits turned off that are not part 
of a standard ASCII character; it is intended for compatibility with other 
systems. 


SEE ALSO 


ctype(3C), getc(3S). 
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NAME 
crypt, setkey, encrypt - generate hashing encryption 


SYNOPSIS 
char *crypt (key, salt) 
char *key, *salt; 


void setkey (key) 
char *key; 


void encrypt (block, ignored) 
char *block; 
int ignored; 

DESCRIPTION 
The crypt routine performs password encryption. It is based on a one-way 
hashing encryption aigorithm with variations intended (among other things) to 
frustrate use of hardware implementations of a key search. 


The key argument is a user’s typed password. The salt argument is a two- 
character string chosen from the set [a-zA-Z0-9./]; this string is used to perturb 
the hashing algorithm in one of 4,096 different ways, after which the password 
is used as the key to encrypt repeatedly a constant string. The returned value 
points to the encrypted password. The first two characters are the salt itself. 


The setkey and encrypt entries provide (rather primitive) access to the actual 
hashing algorithm. The argument of setkey is a character array of length 64 
containing only the characters with numerical value O and 1. If this string is 
divided into groups of 8, the low-order bit in each group is ignored; this gives a 
56-bit key which is set into the machine. This is the key that will be used with 
the hashing algorithm to encrypt the string block with the function encrypt. 


The argument to the encrypt entry is a character array of length 64 containing 
only the characters with numerical value 0 and 1. The argument array is 
modified in place to a similar array representing the bits of the argument after 
having been subjected to the hashing algorithm using the key set by setkey. 
Ignored 1s unused by encrypt but it must be present. 


SEE ALSO 
login(1), passwd(1), getpass(3C), passwd(4). 
CAVEAT 
The return value points to static data that are overwritten by each call. 


WARNING 
The standard CTIX distribution is the international version, which does not 
support encryption. 
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NAME 
Crypt - password and file encryption functions 


SYNOPSIS 
cc [flag ...] file ... -lcrypt 


char *crypt (key, salt) 
char +key, *salt; 


void setkey (key) 
char *key; 


void encrypt (block, flag) 
char *block; 

int flag; 

char *des crypt (key, salt) 
char +key, *salt; 


void des setkey (key) 
char *key; 


void des encrypt (block, flag) 
char *block; 
int flag; 


int run_setkey (p, key) 
int p[2]; 
char *key; 


int run_crypt (offset, buffer, count, p) 
long offset; 

char *buffer; 

unsigned int count; 

int p[2]; 


int crypt_close(p) 
int p[2]; 


DESCRIPTION 
The des crypt routine performs password encryption. It is based on a one-way 
hashing encryption algorithm with variations intended (among other things) to 
frustrate use of hardware implementations of a key search. 


The key argument is a user’s typed password. The salt argument is a two- 
character string chosen from the set [a-zA-Z0-9. /]; this string is used to perturb 
the hashing algorithm in one of 4096 different ways, after which the password 
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is used as the key to encrypt repeatedly a constant string. The returned value 
points to the encrypted password. The first two characters are the salt itself. 


The des_setkey and des encrypt entries provide (rather primitive) access to the 
actual hashing algorithm. The argument of des setkey is a character array of 
length 64 containing only the characters with numerical value 0 and 1. If this 
string is divided into groups of 8, the low-order bit in each group is ignored; this 
gives a 56-bit key which is set into the machine. This is the key that is used 
with the hashing algorithm to encrypt the string block with the function 
des encrypt. 


The argument to the des encrypt entry is a character array of length 64 
containing only the characters with numerical value 0 and 1. The argument 
atray is modified in place to a similar array representing the bits of the 
argument after having been subjected to the hashing algorithm using the key set 
by des setkey. If flag is zero, the argument is encrypted; if non-zero, it is 
decrypted. 


Note that decryption is not provided in the international version of crypt(3X). If 
decryption is attempted with the international version of des_encrypt, an error 
message 1s printed. 


The crypt, setkey, and encrypt routines are front-end routines that invoke 
des_crypt, des_setkey, and des encrypt respectively. 


The routines run_setkey and run_crypt are designed for use by applications that 
need cryptographic capabilities [such as ed(1) and vi(1)] that must be 
compatible with the crypt(1) user-level utility. run_setkey establishes a two- 
way pipe connection with crypi(1), using key as the password argument. The 
run_crypt routine takes a block of characters and transforms the cleartext or 
ciphertext into their ciphertext or cleartext using crypt(1). The offset argument 
is the relative byte position from the beginning of the file that the block of text 
provided in block is coming from; count is the number of characters in block, 
and connection is an array containing indices to a table of input and output file 
streams. When encryption is finished, crypt close is used to terminate the 
connection with crypt(1). 


The run_setkey routine returns -1 if a connection with crypt(1) cannot be 
established; this occurs on international versions of CTIX where crypt(1) is not 
available. If a null key is passed to run_setkey, 0 is returned; otherwise, 1 is 
returned. The run_crypt routine returns -1 if it cannot write output or read input 
from the pipe attached to crypt; otherwise, it returns 0. 


SEE ALSO 
crypt(1), login(1), passwd(1), getpass(3C), passwd(4). 
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DIAGNOSTICS 
In the international version of crypt(3X), a flag argument of 1 to des_encrypt is 
not accepted, and an error message is printed. 


CAVEAT 
The return value in crypt points to static data that are overwritten by each call. 


WARNING 
The standard CTIX distribution is the international version, which does not 
support encryption. 
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NAME 


ctermid - generate file name for terminal 


SYNOPSIS 


#include <stdio.h> 
char *ctermid (s) 
char *s; 


DESCRIPTION 


The ctermid routine generates the path name of the controlling terminal for the 
current process, and stores it in a string. 


If s is a NULL pointer, the string is stored in an internal static area, the contents 
of which are overwritten at the next call to ctermid, and the address of which is 
returned. Otherwise, s is assumed to point to a character array of at least 
L_ctermid elements; the path name is placed in this array and the value of s is 
returned. The constant L_ctermid is defined in the <stdio.h> header file. 


SEE ALSO 


NOTES 


ttyname(3C). 


The difference between ctermid and ttyname(3C) is that ttyname must be 
handed a file descriptor and returns the actual name of the terminal associated 
with that file descriptor, while ctermid returns a string (/dev/tty) that refers to 
the terminal if used as a file name. Thus, ttyname is useful only if the process 
already has at least one file open to a terminal. 
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NAME 
ctime, localtime, gmtime, asctime, cftime, ascftime, tzset - convert date and 
time to string 
SYNOPSIS 
#include <sys/types.h> 
#include <time.h> 


char *ctime (clock) 

time t *clock; 

struct tm *localtime (clock) 
time_t *clock; 

struct tm *gmtime (clock) 
time_t *clock; 

char *asctime (tm) 

Struct tm *tm; 

int cftime(buf, fmt, clock) 
char *buf, +fmt; 

time_t «clock; 

int ascftime (buf, fmt, tm) 
char *buf, +fmt; 

Struct tm *tm; 

extern long timezone, altzone; 
extern int daylight; 

extern char *tzname(2]; 
void tzset ( ) 


DESCRIPTION 
The ctime , localtime , and gmfime routines accept arguments of type time t 
(declared in <sys/types.h>), pointed to by clock, representing the time in 
seconds since 00:00:00 GMT, January 1, 1970. ctime returns a pointer to a 26- 
character string in the following form. All the fields have constant width. 


Fri Sep 13 00:00:00 1986\n\0 


The localtime and gmtime routines return pointers to tm structures, described 
below. focaltime corrects for the main time zone and possible alternate 
(Daylight Savings) time zone; gmtime converts directly to Greenwich Mean 
Time (GMT), which is the time the UNIX system uses. 
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The asctime routine converts a tm structure to a 26-character string, as shown 
in the above example, and returns a pointer to the string. 


Declarations of all the functions and externals, and the tm structure, are in the 
<time.h> header file. The structure declaration follows: 


struct tm { 


int tm_sec; /+ seconds after the minute — [0, 59] +/ 
int tm_min; /+« minutes after the hour — [0, 59] +/ 
int tm_hour; /« hour since midnight — [0, 23] +/ 

int tm_mday; /+ day of the month — [1, 31] */ 

int tm_mon; /* months since January — [0, 11] */ 

int tm_year; /* years since 1900 */ 

Int tm_wday; /+ days since Sunday — [0, 6] +/ 

int tm_yday; /x days since January 1 — [0, 365} +/ 
int tm_isdst; /* flag for daylight savings time +/ 


}; 
If the alternate time zone is in effect, tm_isdst is non-zero. 


The cftime and ascftime routines provide the capabilities of ctime and asctime, 
respectively, as well as additional ones. The cftime routine takes an integer of 
type time_t pointed to by clock and converts it to a character string; ascftime 
takes a pointer to a tm structure and converts it to a character string. In both 
functions, the characters are placed into the array pointed to by buf (plus a 
terminating \Q) and the value returned is the number of such characters (not 
counting the terminating \0). The fmt argument controls the format of the 
resulting string; it is a character string that consists of field descriptors and text 
characters, reminiscent of prinif(3S). Each field descriptor consists of a % 
character followed by another character which specifies the replacement for the 
field descriptor. All other characters are copied from fmt into the result. The 
following field descriptors are supported: 


%o % same as % 

%a abbreviated weekday name 

Fo A full weekday name 

%b abbreviated month name 

%B full month name 

%d day of month (01 - 31 ) 

%D date as %m/%d/%y 

%e day of month (1-31; single digits are preceded by a blank) 
%h abbreviated month name 

%H hour ( 00 - 23 ) 


_ 
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%I hour ( 00 - 12 ) 

%} day number of year ( 001 - 366 ) 

%om month number ( 01 - 12 ) 

%M minute ( 00 - 59 ) 

Fon same as \n 

Fp ante meridian or post meridian 

Gor time as %1:%M:%S %p 

%R time as %H:%M 

%S seconds ( 00 - 59 ) 

Jot insert a tab 

%T time as %H:%M:%S 

%U week number of year (01 - 52), Sunday is the first day of week 
Tow weekday number ( Sunday = 0 ) 

%W week number of year (01 - 52), Monday is the first day of week 
%x Local specific date format 

%X Local specific time format 

oy year within century (00 - 99 ) 

%Y year as ccyy (for example, 1986) 

%L time zone name 


The difference between %U and %W lies in which day is counted as the first 
of the week. Week number 01 is the first week with four or more January days 
in it. 

The example below shows what the values in the tm structure would look like 
for Thursday, August 28, 1986 at 12:44:36 in New Jersey. 


ascftime (buf, "%A %h %d %j", tm) 
This example would result in the buffer containing Thursday Aug 28 240. 


If fmt is (char *)0, the value of the environment variable CFTIME is used. If 
CFTIME is undefined or empty, a default format is used. The default format 
String is taken from the file that contains the date and time strings associated 
with the then current language [see below for details on changing the current 
language and cftime(4) for a description of the structure of these files]. 


The user can request that the output of cftime and ascftime be in a specific 
language by setting the environment variable LANGUAGE to the desired 
language. If LANGUAGE is empty, unset or set to an unsupported language, the 
last language requested will be used (the default is the usa_english strings). 


The external long variable timezone contains the difference, in seconds, 
between GMT and the main time zone; the external long variable altzone 
contains the difference, in seconds, between GMT and the alternate time zone; 


ae 
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both timezone and altzone default to 0 (GMT). The external variable daylight is 
non-zero if an alternate time zone exists. The time zone names are contained in 
the external variable tzname, which by default is set as follows: 


char *tzname[2] = { "cmt", " " 3}; 


The functions know about the peculiarities of this conversion for various time 
periods for the U.S.A (specifically, the years 1974, 1975, and 1987). The 
functions will handle the new daylight savings time starting with the first 
Sunday in April, 1987. 


The tzset routine uses the contents of the environment variable TZ to override 
the value of the different external variables. The syntax of TZ can be described 
as follows: 


TZ — zone 
| zone signed_time 
| zone signed_time zone 
/ zone signed time zone dst 
zone —> letter letter letter 
signed time — sign time 
/ time 
time — hour 
/ hour : minute 
/ hour : minute : 
dst — signed_time 
/ signed _time ; dst date , 
/; dst date , dst date 
dst date — julian 


/ julian | time 
letter — a/fA/b/B/../2z/Z 
hour —~ 00/01 /.../23 
minute > 00/01 /.../59 
second > 00 /01/.../59 
julian > 001 | 002 | .../ 366 
sign > —/{+ 


izset scans the contents of the environment variable and assigns the different 
fields to the respective variable. For example, the setting for New Jersey in 
1986 could be either of the following: 


“ESTS5EDT4;117/2:00:00,299/2:00:00". 
HBESTSEDT 
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A southern hemisphere setting such as the Cook Islands could be the following: 
“KDT9:30KST10:00;64/5 :00,303/20:00" 


When the longer format is used, the variable must be surrounded by double 
quotes as shown. For more details, see timezone(4) and environ(S). In the 
longer version of the New Jersey example of TZ, tzname[0] is EST, timezone 
will be set to 5*60*60, tzname[1] is EDT, altzone will be set to 4*60*60, the 
Starting date of the alternate time zone is the 117th day at 2 AM, the ending 
date of the alternate time zone is the 299th day at 2 AM, and daylight will be 
set to non-zero. Starting and ending times are relative to the alternate time 
zone. If the alternate time zone start and end dates and the time are not 
provided, the days for the United States that year will be used and the time will 
be 2 AM. If the start and end dates are provided but the time is not provided, 
the time will be midnight. The effects of tzset are thus to change the values of 
the external variables timezone, altzone , daylight and tzname. tzset is called by 
localtime and can also be called explicitly by the user. 


FILES 
/lib/cftime - directory that contains the language specific printable files 
SEE ALSO 
time(2), getenv(3C), printf(3S), putenv(3C), cftime(4), timezone(4), environ(5). 


CAVEAT 
The return values for ctime, localtime and gmtime point to static data whose 
content is overwritten by each call. 


Setting the time during the interval of change from timezone to altzone or vice 
versa can produce unpredictable results. 


The system administrator must change the Julian start and end days annually if 
the full form of the TZ variable is specified. 
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NAME 
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isdigit, isxdigit, islower, isupper, isalpha, isalnum, isspace, iscntrl, ispunct, 


isprint, 


isgraph, isascii, tolower, toupper, toascci, _tolower, _toupper, 


setchrclass - character handling 


SYNOPSIS 


#include <ctype.h> 


int isdigit (c); 


int ¢; 


tolower(c) 


int ¢; 


int setchrclass (chrclass) 
char *chrclass; 


DESCRIPTION 


The character classification macros listed below return nonzero for true, zero 
for false. isascii is defined on all integer values; the rest are defined on valid 
members of the character set and on the single value EOF [see stdio(3S)] 
(guaranteed not to be a character set member). 


isdigit 
isxdigit 
islower 


isupper 


isalpha 


isalnum 


isspace 


iscntrl 


ispunct 


Tests for the digits 0 through 9. 


Tests for any character for which isdigit is true or for the letters a 
through f or A through F. 


Tests for any lowercase letter as defined by the character set. 
Tests for any uppercase letter as defined by the character set. 


Tests for any character for which islower or isupper is true and 
possibly any others as defined by the character set. 


Tests for any character for which isalpha or isdigit is true. 


Tests for a space, horizontal-tab, carriage return, newline, 
vertical-tab, or form-feed. 


Tests for ‘‘control characters’’ as defined by the character set. 


Tests for any character other than the ones for which isalnum, 
iscntrl, or isspace is true or space. 
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FILES 


isprint Tests for a space or any character for which itsalnum or ispunct is 
true or other ‘‘printing character’’ as defined by the character 
set. 

isgraph Tests for any character for which isprint is true, except for space. 

isascil Tests for an ASCII character (a non-negative number less than 
0200.) 


The conversion functions and macros translate a character from lowercase 
(uppercase) to uppercase (lowercase). 


tolower If the character is one for which isupper is true and there a 
corresponding lowercase character, tolower returns the 
corresponding lowercase character. Otherwise, the character is 
returned unchanged. 


toupper If the character is one for which islower is true and there is a 
corresponding uppercase character, toupper returns the 
corresponding uppercase character. Otherwise, the character is 


returned unchanged. 
toasclt Turns off the bits that are not part of the ASCH character set. 
_tolower Returns the lowercase representation of a character for which 


isupper is true; otherwise, undefined. 


_toupper Returns the uppercase representation of a character for which 
islower 1S true; otherwise, undefined. 


The conversion macros have the same functionality of the functions on valid 
input, but the macros are faster because they do not do range checking. 


All the character classification macros and the conversion functions and macros 
do a table lookup. 


The setchrclass routine itializes the table used by these functions and macros to 
a specific character classification set. It uses the value of its argument or the 
value of the environment variable CHRCLASS as the name of the datafile 
containing the information for the desired character set. These datafiles are 
searched for in the special directory /lib/chrclass. 


If chrclass is (char *)0, the value of the environment variable CHRCLASS is 
used. If CHRCLASS is not set or is undefined, the table retains its current value, 
which at initialization time is ascii. 


/lib/chrclass - directory containing the datafiles for setchrclass 
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SEE ALSO 
ascii(5), chrtbl(1), environ(5), stdio(3S). 
DIAGNOSTICS 


If the argument to any of the character handling macros is not in the domain of 
the function, the result is undefined. 


If setchrclass does not successfully fill the table, the table will not change 
(initially “‘ascii’’) and -1 is returned. If everything works, setchrclass returns 0. 
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NAME 
curses - terminal screen handling and optimization package 


OVERVIEW 
The curses manual page is organized as follows: 


SYNOPSIS: 


° Summary of parameters used by curses routines 

e Alphabetical list of curses routines, showing parameters 
DESCRIPTION: 
An overview of how curses routines should be used 
ROUTINES (descriptions of each curses routine are grouped under the 
appropriate topics): 

° Overall Screen Manipulation 

° Window and Pad Manipulation 

e Output 

e Input 

@ Output Options Setting 

e Input Options Setting 


® Environment Queries 
® Color Manipulation 
e Soft Labels 
6 Low-level Curses Access 
® Terminfo-Level Manipulations 
e Termcap Emulation 
® Miscellaneous 
e Use of curscr 
ATTRIBUTES 
FUNCTION-KEYS 
LINE GRAPHICS 
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SYNOPSIS 
ce [ flag ... ] file ... -lcurses [ library ... ] 
#include <curses.h> (automatically includes <stdio.h>, <termio.h>, 


and <unctri.h>). 


The parameters in the following list are not global variables, but rather this 
is a summary of the parameters used by the curses library routines. All 
routines return the int values ERR or OK unless otherwise noted. Routines 
that return pointers always return NULL on error. (ERR, OK, and NULL are 
all defined in <curses.h>.) Routines that return integers are not listed in the 
parameter list below. 


bool bf 


char **area,+boolnames|[ ], *boolcodes[ ], *boolfnames[ ], *bp 
char *cap, *capname, codename[2], erasechar, *filename, «fmt 
char *keyname, killchar, *label, *longname 

char *name, *numnames[ ], *numcodes[ ], *numfnames[ } 

char *slk_label, *str, *strnames[ ], *strcodes[], *strfnames[ ] 
char *term, *tgetstr, *tigetstr, *tgoto, *tparm, *type 


chtype attrs, ch, horch, vertch 
FILE *infd, *outfd 


int begin_x, begin_y, begline, bot, c, col, count 

int dmaxcol, dmaxrow, dmincol, dminrow, *errret, fildes 
int [*init( )], labfmt, labnum, line 

int ms, ncols, new, newcol, newrow, nlines, numlines 
int oldcol, oldrow, overlay 

int pl, p2, p9, pmincol, pminrow, [*putc( )], row 

int smaxcol, smaxrow, smincol, sminrow, start 

int tenths, top, visibility, x, y 

short pair, f, b, color, r, g, b 


SCREEN *new, *newterm, *set_term 

TERMINAL *cur_term, *nterm, *oterm 

va_list varglist 

WINDOW ‘curscr, *dstwin, *initscr, *newpad, *newwin, *orig 
WINDOW *pad, *srcwin, *stdscr, *subpad, *subwin, *win 


addch(ch) 
addstr(str) 
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attroff(attrs) 

attron(attrs) 

attrset(attrs) 

baudrate( ) 

beep() 

box(win, vertch, horch) 

cbreak( ) 

clear( ) 

clearok(win, bf) 

clrtobot( ) 

cirtoeol( ) 

copywin(srcwin, dstwin, sminrow, smincol, dminrow, dmincol, dmaxrow, 
dmaxcol, overlay) 

curs set(visibility) 

def prog _mode( ) 

def_shell_mode( ) 

del_curterm(oterm) 

delay_output(ms) 

delch( ) 

deleteln( ) 

delwin(win) 

doupdate( ) 

draino(ms) 

echo( ) 

echochar(ch) 

endwin( ) 

erase() 

erasechar( ) 

filter() 

flash() 

flushinp( ) 

garbagedlines(win, begline, numlines) 

getbegyx(win, y, x) 

getch() 

getmaxyx(win, y, x) 

getstr(str) 

getsyx(y, x) 

getyx(win, y, x) 

halfdelay(tenths) 

has colors() 

has _ic() 
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has_il() 

idlok(win, bf) 

inch( ) 

init_color(color, r, g, b) 
init_pair(pair, f, b) 

initscr( ) 

insch(ch) 

insertIn() 

intrflush(win, bf) 

isendwin( ) 

keyname(c) 

keypad(win, bf) 

killchar() 

leaveok(win, bf) 

longname( ) 

meta(win, bf) 

move(y, x) 

mvaddch(y, x, ch) 
mvaddstr(y, x, str) 
mvcur(oldrow, oldcol, newrow, newcol) 
mvdelch(y, x) 

mvgetch(y, x) 

mvgetstr(y, x, str) 

mvinch(y, x) 

mvinsch(y, x, ch) 
mvprintw(y, x, fmt [, arg...]) 
mvscanw(y, x, fmt [, arg...]) 
mvywaddch(win, y, x, ch) 
mvwaddstr(win, y, x, Str) 
mvywdelch(win, y, x) 
mvwegetch(win, y, x) 
mvywgetstr(win, y, X, str) 
mvywin(win, y, X) 
mvywinch(win, y, x) 
mvwinsch(win, y, x, ch) 
mvwprintw(win, y, x, fmt [, arg...]}) 
mvwscanw(win, y, x, fmt [, arg ...]) 
napms(ms) 

newpad(nlines, ncols) 
newterm(type, outfd, infd) 
newwin(nlines, ncols, begin_y, begin_x) 
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ni() 

nocbreak( ) 

nodelay(win, bf) 

noecho( ) 

nonl( ) 

noraw( ) 

notimeout(win, bf) 

overlay(srcwin, dstwin) 

overwrite(srcwin, dstwin) 

pair_content(pair, &f, &b) 

pechochar(pad, ch) 

pnoutrefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 
prefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 


printw(imt (, arg...) 


putp(str) 

raw() 

refresh( ) 

reset_prog mode( ) 
reset shell_mode( ) 
resetty( ) 
restartterm(term, fildes, errret) 
ripoffline(iine, init) 
savetty() 

scanw(fmt [, arg ...]) 
scr_dump(filename) 
scr_init(filename) 
scr_restore(filename) 
scroll(win) 
scrollok(win, bf) 
set_curterm(nterm) 
set_term(new) 
setscrreg(top, bot) 
setsyx(y, x) 
setupterm(term, fildes, errret) 
set_attron(attrs) 
set_attrset(attrs) 
set_attroff(attrs) 
slk_clear() 
slk_init(fmt) 

sik label(labnum) 
slk_noutrefresh( ) 
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slk_refresh( ) 

slk_restore( ) 
slk_set(labnum, label, fmt) 
slk_touch( ) 

standend( ) 

standout( ) 

start_color( ) 

subpad(orig, nlines, ncols, begin_y, begin_x) 
subwin(orig, nlines, ncols, begin_y, begin_x) 
tgetent(bp, name) 
tgetflag(codename) 
tgetnum(codename) 
tgetstr(codename, area) 
tgoto(cap, col, row) 
tigetflag(capname) 
tigetnum(capnamce) 
tigetstr(capname) 
touchline(win, start, count) 
touchwin(win) 

tparm(str, pl, p2, ..., p9) 
tputs(str, count, putc) 
typeahead(fildes) 

unctrI(c) 

ungetch(c) 

vidattr(attrs) 

vidputs(attrs, putc) 
vwprintw(win, fmt, varglist) 
vwscanw(win, fmt, varglist) 
waddch(win, ch) 
waddstr(win, str) 
wattroff(win, attrs) 
wattron(win, attrs) 
wattrset(win, attrs) 
wclear(win) 
wclirtobot(win) 
welrtoeol(win) 
wdelch(win) 
wdeleteln(win) 
wechochar(win, ch) 
werase(win) 

wegetch(win) 
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wegetstr(win, str) 
winch(win) 

winsch(win, ch) 
winsertin(win) 

wmove(win, y, x) 
wnoutrefresh(win) 
wprintw(win, fmt [, arg...]) 
wrefresh(win) 
wscanw(win, fmt [, arg...]) 
wsetscrreg(win, top, bot) 
wstandend(win) 
wstandout(win) 


DESCRIPTION 

The curses routines give ihe user a terminal-independent method of updating 
screens with reasonable optimization. 

In order to initialize the routines, # include <curses.h> must be included at the 
beginning of files that use any curses routines. In addition, the routine initscr( ) 
or newterm() must be called before any of the other routines that deal with 
windows and screens are used. (Three exceptions are noted where they apply.) 
The routine endwin() must be called before exiting. To get character-at-a-time 
input without echoing, (most interactive, screen oriented programs want this) 
after calling initser() you should call ‘‘cbreak(); noecho();’’ Most programs 
would additionally call ‘‘nonl(); intrflush (stdscr, FALSE); keypad(stdscr, 
TRUE);’’. 


Before a curses program is run, a terminal’s tab stops should be set and its 
initialization strings, if defined, must be output. This can be done by executing 
the tput init command after the shell environment variable TERM has been 
exported. For further details, see profile(4), tput(1), and the ‘‘Tabs and 
Initialization’’ subsection of terminfo(4). 


The curses library contains routines that manipulate data structures called 
windows that can be thought of as two-dimensional arrays of characters 
representing all or part of a terminal screen. A default window called stdscr is 
supplied, which is the size of the terminal screen. Others can be created with 
newwin(). Windows are referred to by variables declared as WINDOW #*; the 
type WINDOW is defined in <curses.h> to be a structure. These data structures 
are manipulated with routines described below, among which the most basic are 
move() and addch(). (More general versions of these routines are included 
with names beginning with w, allowing you to specify a window. The routines 
not beginning with w usually affect stdscr.) Then refresh() is called, telling 
the routines to make the user’s terminal screen look like stdscr. The characters 


oF 
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in a window are actually of type chtype, so that other information about the 
character can also be stored with each character. 


Special windows called pads can also be manipulated. These are windows 
which are not constrained to the size of the screen and whose contents need not 
be displayed completely. See the description of newpad() under *“*Window 
and Pad Manipulation’’ for more information. 


In addition to drawing characters on the screen, video attributes can be included 
which cause the characters to show up in modes such as underlined or in reverse 
video on terminals that support such display enhancements. Line drawing 
characters can be specified to be output. On input, curses is also able to 
translate arrow and function keys that transmit escape sequences into single 
values. The video attributes, line drawing characters, and input values use 
names, defined in <curses.h>, such as A REVERSE, ACS HLINE, and 
KEY LEFT. 


Routines that manipulate color on color alphanumeric terminals are new in this 
release of curses. To use these routines, start_color() must be called, usually 
right after initscr(). Colors are always used in pairs (referred to as color-pairs). 
A color-pair consists of a foreground color (for characters) and a background 
color (for the field the characters are displayed on). A programmer initializes a 
color-pair with the routine init pair(). After it has been initialized, 
COLOR_PAIR(n), a macro defined in <curses.h>, can be used in the same ways 
other video attributes can be used. If a terminal is capable of redefining colors, 
the programmer can use the routine init_color() to change the definition of a 
color. The routines has _color() and can_change color() return TRUE or 
FALSE, depending on whether the terminal has color capabilities and whether 
the user can change the colors. The routine color_content() allows a user to 
identify the amounts of red, green, and blue components in an initialized color. 
The routine pair_content() allows a user to find out how a given color-pair is 
currently defined. 


curses also defines the WINDOW * variable, curscr, which is used only for 
certain low-level operations like clearing and redrawing a garbaged screen. 
curscr can be used in only a few routines. If the window argument to 
clearok() is curscr, the next call to wrefresh() with any window causes the 
screen to be cleared and repainted from scratch. If the window argument to 
wrefresh( ) is curscr, the screen is immediately cleared and repainted from 
scratch. This is how most programs would implement a ‘‘repaint-screen”’ 
function. More information on using curscr is provided where its use is 
appropriate. 
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The environment variables LINES and COLUMNS can be set to override 
terminfo’s idea of how large a screen is. These can be used in an AT&T 
Teletype 5620 layer, for example, where the size of a screen is changeable. 


If the environment variable TERMINFO is defined, any program using curses 
checks for a local terminal definition before checking in the standard place. For 
example, if the environment variable TERM is set to act4, then the compiled 
terminal definition is found in /usr/lib/terminfo/a/act4. (The a is copied from 
the first letter of act4 to avoid creation of huge directories.) However, if 
TERMINFO is’ set to $HOME/myterms, curses _ first checks 
S$HOME/myterms/a/act4 , and, if that fails, then checks /usr/lib/terminfo/a/act4 . 
This is useful for developing experimental definitions or when write permission 
on /usr/lib/terminfo is not available. 


The integer variables LINES and COLS are defined in <curses.h>, and is filled 
in by imitscr() with the size of the screen. (For more information, see the 
subsection ““Terminfo-Level Manipulations.’’) The integer variables COLORS 
and COLOR _PAIRS are also defined in <curses.h> and contain, respectively, 
the maximum number of colors and color-pairs the terminal can support. They 
are initialized by start_color(). The constants TRUE and FALSE have the 
values 1 and 0, respectively. The constants ERR and OK are returned by 
routines to indicate whether the routine successfully completed. These 
constants are also defined in <curses.h>. 


ROUTINES 
Many of the following routines have two or more versions. The routines 
prefixed with w require a window argument. The routines prefixed with p 
require a pad argument. Those without a prefix generally use stdscr. 


The routines prefixed with my require y and x coordinates to move to before 
performing the appropriate action. The mv() routines imply a call to move() 
before the call to the other routine. The window argument is always specified 
before the coordinates. y always refers to the row (of the window), and x 
always refers to the column. The upper-left corner is always (0,0), not (1,1). 
The routines prefixed with mvw take both a window argument and y and x 
coordinates. 


In each case, win is the window affected and pad is the pad affected. (win and 
pad are always of type WINDOW *.) Option-setting routines require a boolean 
flag bf with the value TRUE or FALSE. (bf is always of type bool.) The types 
WINDOW, bool, and chtype are defined in <curses.h>. See the SYNOPSIS for 
a summary of what types all variables are. 


All routines return either the integer ERR or the integer OK, unless otherwise 
noted. Routines that return pointers always return NULL on error. 
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Sometimes the description of a routine refers to a second routine. If the routine 
referred to is prefixed with a w, then you should assume that other versions of 
the second routine behave similarly. For example, the description of initscr( ) 
refers to wrefresh(). This implies that the same result occurs if refresh() is 
called. 


Overall Screen Manipulation 
WINDOW #*initscr( ) 

The first routine called should almost always be imitser(). [The 
exceptions are slk_init(), filter(), and ripoffline().] This determines 
the terminal type and initializes all curses data structures. initscr() also 
arranges that the first call to wrefresh() clears the screen. If errors 
occur, initscr() writes an appropriate error message to standard error 
and exit; otherwise, a pointer to stdscr is retumed. If the program wants 
an indication of error conditions, newterm( ) shouid be used instead of 
initscr( ). initscr() should only be called once per application. 


endwin() 
A program should always call endwin() before exiting or escaping from 
curses mode temporarily, to do a shell escape or system(3S) call, for 
example. This routine restores tty(7) modes, moves the cursor to the 
lower-left corner of the screen, and resets the terminal into the proper 
non-visual mode. To resume after a temporary escape, call wrefresh() 
or doupdate( ). 


isendwin( ) 
This routine returns TRUE if endwin() has been called without any 
subsequent calls to wrefresh( ). 


SCREEN *newterm(type, outfd, infd) 

A program that outputs to more than one terminal must use newterm( ) 
for each terminal instead of initscr(). A program that wants an 
indication of error conditions, so that it can continue to run in a line- 
oriented mode if the terminal cannot support a screen-oriented program, 
must also use this routine. newterm() should be called once for each 
terminal. It returns a variable of type SCREEN* that should be saved as 
a reference to that terminal. The arguments are the type of the terminal 
to be used in place of the environment variable TERM; outfd, a 
stdio (3S) file pointer for output to the terminal; and infd, another file 
pointer for input from the terminal. When it is done running, the 
program must also call endwin() for each terminal being used. If 
newterm() is called more than once for the same terminal, the first 
terminal referred to must be the last one for which endwin( ) is called. 
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SCREEN *set_term(new) 
This routine is used to switch between different terminals. The screen 
reference new becomes the new current terminal. A pointer to the 
screen of the previous terminal is returned by the routine. This is the 
only routine which manipulates SCREEN pointers; all other routines 
affect only the current terminal. 
Window and Pad Manipulation 
refresh( ) 
wrefresh (win) 
These routines [or prefresh( ), pnoutrefresh( ), wnoutrefresh(), or 
doupdate()] must be called to write output to the terminal, as most 
other routines merely manipulate data structures. wrefresh() copies 
the named window to the physical terminal screen, taking into account 
wiiat is already there in order to minimize the amount of information 
that’s sent to the terminal (called optimization). refresh({) does the 
same thing, except it uses stdscr as a default window. Unless 
leaveok( ) has been enabled, the physical cursor of the terminal is left 
at the location of the window’s cursor. The number of characters 
output to the terminal is returned. 


Note that refresh( ) is a macro. 


wnoutrefresh(win) 

doupdate() 
These two routines allow multiple updates to the physical terminal 
screen with more efficiency than wrefresh() alone. How this is 
accomplished is described in the next paragraph. 


curses keeps two data structures representing the terminal screen: a 
physical terminal screen, describing what is actually on the screen, and 
a virtual terminal screen, describing what the programmer wants to 
have on the screen. wrefresh() works by first calling 
wnoutrefresh( ), which copys the named window to the virtual screen, 
and then by calling doupdate(), which compares the virtual screen to 
the physical screen and does the actual update. If the programmer 
wishes to output several windows at once, a series of calls to 
wrefresh() results in alternating calls to wnoutrefresh() and 
doupdate(), causing several bursts of output to the screen. By first 
calling wnoutrefresh() for each window, it is then possible to call 
doupdate() once, resulting in only one burst of output, with probably 
fewer total characters transmitted and certainly less processor time 
used. 
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WINDOW *newwin(nlines, ncols, begin_y, begin_x) 
This routine creates and returns a pointer to a new window with the 
given number of lines (or rows), nlines, and columns, ncols. The 
upper-left corner of the window is at line begin_y, column begin x. If 
either nlines or ncols is 0, they are set to the value of lines-begin_y and 
cols-begin x. A new full-screen window is created by calling 
newwin (0,0,0,0). 


mvwin(win, y, x) 
This routine noves the window to position the upper-left corner at (y, 
x). If the move would cause any portion of the window to be off the 
screen, it is an error and the window is not moved. 


WINDOW *subwin(orig, nlines, ncols, begin_y, begin_x) 

This routine creates and returns a pointer to a new window with the 
given number of lines (or rows), nlines, and columns, ncols. The 
window is at position (begin _y, begin_x) on the screen. (This position 
is relative to the screen and not to the window orig.) The window is 
made in the middle of the window orig, so that changes made to one 
window affect the character image of both windows. When changing 
the image of a subwindow, it is necessary to call touchwin() or 
touchline( ) on orig before calling wrefresh( ) on orig. 


delwin(win) 
This routine deletes the named window, freeing up all memory 
associated with it. If you try to delete a main window before all of its 
subwindows are deleted, ERR is returned. 


WINDOW *newpad(nlines, ncols) 

This routine creates and returns a pointer to a new pad data structure 
with the given number of lines (or rows), nlines, and columns, acols. 
A pad is a window that is not restricted by the screen size and is not 
necessarily associated with a particular part of the screen. Pads can be 
used when a large window is needed, and only a part of the window is 
on the screen at one time. Automatic refreshes of pads (for example, 
from scrolling or echoing of input) do not occur. It is not legal to call 
wrefresh() with a pad as an argument; the routines prefresh() or 
pnoutrefresh( ) should be called instead. Note that these routines 
require additional parameters to specify the part of the pad to be 
displayed and the location on the screen to be used for display. 
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WINDOW *subpad(orig, nlines, ncols, begin_y, begin_x) 
This routine creates and returns a pointer to a subwindow within a pad 
with the given number of lines (or rows), niines, and columns, ncols. 
Unlike subwin(), which uses screen coordinates, the window is at 
position (begin _y, begin x) on the pad. The window is made in the 
middle of the window orig, so that changes made to one window affect 
the character image of both windows. When changing the image of a 
subwindow, it is necessary to call touchwin() or touchline( ) on orig 
before calling prefresh( ) on orig. 

prefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 

pnoutrefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 
These routines are analogous to wrefresh() and wnoutrefresh( ) 
except that pads, instead of windows, are involved. The additional 
parameters are needed to indicate what part of the pad and screen are 
involved. pminrow and pmincol specify the upper-left corner, in the 
pad, of the rectangle to be displayed. sminrow, smincol, smaxrow, and 
smaxcol specify the edges, on the screen, of the rectangle to be 
displayed in. The lower-right corner in the pad of the rectangle to be 
displayed is calculated from the screen coordinates, since the 
rectangles must be the same size. Both rectangles must be entirely 
contained within their respective structures. Negative values of 
pminrow , pmincol, sminrow, or smincol are treated as if they were 
zero. 

Output 

These routines are used to manipulate text in windows. 

addch(ch) 

waddch(win, ch) 

mvaddch(y, x, ch) 

mvwaddch(win, y, x, ch) 
The character ch is put into the window at the current cursor position 
of the window and the position of the window cursor is advanced. Its 
function is similar to that of putchar [see putc(3S)). At the right 
margin, an automatic newline is performed. At the bottom of the 
scrolling region, if scrollok() is enabled, the scrolling region is 
scrolled up one line. 
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If ch is a tab, newline, or backspace, the cursor is moved appropriately 
within the window. A newline also does a wcirtoeol( ) before moving. 
Tabs are considered to be at every eighth column. If ch is another 
control character, it is drawn in the Control X notation. [Calling 
winch() on a position in the window containing a control character 
does not return the control character, but instead returns one character 
of the representation of the control character.] Video attributes can be 
combined with a character by ORing them into the parameter. This 
results in these attributes also being set. [The intent here is that text, 
including attributes, can be copied from one place to another using 
winch( ) and waddch().] See wstandout(), below. 


Note that ch is actually of type chtype, not a character. 


echochar(ch) 
wechochar(win, ch) 
pechochar(pad, ch) 


These routines are functionally equivalent to a call to addch(ch) 
followed by a call to refresh( ), a call to waddch(win, ch) followed by 
a call to wrefresh(win), or a call to waddch(pad, ch) followed by a 
call to prefresh(pad). The knowledge that only a single character is 
being output is taken into consideration and, for non-control 
characters, a considerable performance gain can be seen by using these 
routines instead of their equivalents. In the case of pechochar(), the 
last location of the pad on the screen is reused for the arguments to 
prefreshc ). 


Note that ch is actually of type chtype, not a character. 


Note that echochar( ) is a macro. 


addstr(str) 

waddstr(win, str) 
mvywaddstr(win, y, x, str) 
mvaddstr(y, x, str) 


These routines write all the characters of the null-terminated character 
string str on the given window. This is equivalent to calling waddch( ) 
once for each character in the string. 


Note that addstr(), mvaddstr(), and mvwaddstr( ) are macros. 
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attroff(attrs) 
wattroff(win, attrs) 
attron(attrs) 
wattron(win, attrs) 
attrset(attrs) 
wattrset(win, attrs) 
standend( ) 
wstandend(win) 
standout( ) 
wstandout(win) 


beep() 
flash() 


These routines manipulate the current attributes of the named window. 
These attributes can be any combination of A_STANDOUT, 
A_REVERSE, A_BOLD, A_DIM, A_BLINK, A_UNDERLINE, and 
A_ALTCHARSET, as well as the macro COLOR PAIR(). These 
constants are defined in <curses.h> and can be combined with the C 
logical OR (1) operator. 


The current attributes of a window are applied to all characters that are 
written into the window with waddch(). Attributes are a property of 
the character, and move with the character through any scrolling and 
insert/delete line/character operations. To the extent possible on the 
particular terminal, they are displayed as the graphic rendition of the 
characters put on the screen. 


wattrset(win, attrs) sets the current attributes of the given window to 
attrs. wattroff(win, attrs) turns off the named attributes without 
turning on or off any other attributes. wattron(win, attrs) turns on the 
named attributes without affecting any others. wstandout(win, attrs) 
is the same as wattron(win, A STANDOUT). wstandend(win, attrs) is 
the same as wattrset(win, 0), that is, it turns off all attributes. 


Note that wattroff(), wattron(), wattrset(), wstandend(), and 
wstandout( ) return 1 at all times. 


Note that attrs is actually of type chtype, not a character. 


Note that attroff(), attron(), attrset(), standend(), and standout() 
are macros. 


These routines are used to signal the terminal user. beep() sounds the 
audible alarm on the terminal, if possible, and if not, flashes the screen 
(visible bell), if that is possible. flash() flashes the screen, and if that 
is not possible, sounds the audible signal. If neither signal is possible, 
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nothing happens. Nearly all terminals have an audible signal (bell or 
beep), but only some can flash the screen. 


box(win, vertch, horch) 
A box is drawn around the edge of the window, win. vertch and horch 
are the characters the box is to be drawn with. If vertch and horch are 
0, then appropriate default characters, ACS_VLINE and ACS HLINE, 
are used. 


Note that vertch and horch are actually of type chtype, not characters. 


erase( ) 
werase(win) 
These routines copy blanks to every position in the window. 


Note that erase( ) is a macro. 


clear( ) 

wclear(win) 
These routines are like erase() and werase(), but they also call 
clearok( ), arranging that the screen is cleared completely on the next 
call to wrefresh( ) for that window and repainted from scratch. 


Note that clear( ) is a macro. 


clrtobot( ) 

wclrtobot(win) 
All lines below the cursor in this window are erased. Also, the current 
line to the right of the cursor, inclusive, is erased. 


Note that clrtobot( ) is a macro. 


clrtoeol( ) 
welirtoeol(win) 
The current line to the right of the cursor, inclusive, is erased. 


Note that clrtoeol( ) is a macro. 


delay _output(ms) 
Insert a ms millisecond pause in the output. It is not recommended that 
this routine be used extensively, because padding characters are used 
rather than a processor pause. 
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delch( ) 

wdelch(win) 

mvdelch(y, x) 

mvywdelch(win, y, x) 
The character under the cursor in the window is deleted. All 
characters to the right on the same line are moved to the left one 
position and the last character on the line ts filled with a blank. The 
Cursor position does not change [after moving to (y, x), if specified]. 
(This does not imply use of the hardware ‘‘delete-character’’ feature.) 


Note that delch(), mvdelch( ), and mvwdelch( ) are macros. 


deleteln( ) 

wdeleteln(win) 
The line under the cursor in the window is deleted. All lines below the 
current line are moved up one line. The bottom line of the window is 
Cleared. The cursor position does not change. (This does not imply 
use of the hardware ‘‘delete-line’’ feature.) 


Note that deleteln( ) is a macro. 


getyx(win, y, x) 
The cursor position of the window is placed in the two integer 
variables y and x. 


Note that getyx() is a macro, so no ampersand (&) is necessary before 
the variables y and x. 


getbegyx(win, y, x) 

getmaxyx(win, y, x) 
The current beginning coordinates [getbegyx( )) or size (getmaxyx( )] 
of the specified window are placed in the two integer variables y and 
xX. 


Note that getbegyx() and getmaxyx() are macros, so no & is 
necessary before the variables y and x. 


insch(ch) 

winsch(win, ch) 

mvwinsch(win, y, x, ch) 

mvinsch(y, x, ch) 
The character ch is inserted before the character under the cursor. All 
characters to the right are moved one space to the right, losing the 
rightmost character of the line. The cursor position does not change 
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[after moving to (y, x), if specified]. (This does not imply use of the 
hardware “‘insert-character’’ feature.) 


Note that ch is actually of type chtype, not a character. 
Note that insch(), mvinsch( ), and mywinsch( ) are macros. 


insertin() 

winsertin(win) 
A blank line is inserted above the current line and the bottom line is 
lost. (This does not imply use of the hardware ‘‘insert-line’’ feature.) 


Note that insertIn() is a macro. 


move(y, x) 

wmove(win, y, X) 
The cursor associaied wiih ihe window is moved to lime (row) y, 
column x. This does not move the physical cursor of the terminal until 
wrefresh() is called. The position specified is relative to the upper- 
left corner of the window, which is (0, 0). 


Note that move( ) is a macro. 


overlay(srcwin, dstwin) 

overwrite(srcwin, dstwin) 
These routines overlay text from srcwin on top of text from dstwin 
wherever the two windows overlap. The difference is that overlay( ) is 
non-destructive (blanks are not copied), while overwrite() is 
destructive. 


copywin(srcwin, dstwin, sminrow, smincol, dminrow, 
dmincol, dmaxrow, dmaxcol, overlay) 
This routine provides a finer grain of control over the overlay() and 
overwrite() routines. As in the prefresh() routine, a rectangle is 
specified in the destination window, (dminrow, dmincol) and 
(dmaxrow, dmaxcol), and the upper-left-corner coordinates of the 
source window, (sminrow, smincol). If the argument overlay is true, 
then copying is non-destructive, as in overlay( ). 


printw(fmt [, arg ...]) 

wprintw(win, fmt [, arg ...]) 

mvprintw(y, x, fmt [, arg ...]) 

mvywprintw(win, y, x, fmt [, arg ...]) 
These routines are analogous to printf(3). The string which would be 
Output by printf(3) is instead output using waddstr() on the given 
window. 
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vwprintw(win, fmt, varglist) 
This routine corresponds to vfprinif{(3S). It performs a wprintw() 
using a variable argument list. The third argument is a va list, a 
pointer to a list of arguments, as defined in <varargs.h>. See the 
vprint{(3S) and varargs(S) manual pages for a detailed description on 
how to use variable argument lists. 

scroli(win) 
The window is scrolled up one line. This involves moving the lines in 
the window data structure. As an optimization, if the window is stdscr 
and the scrolling region is the entire window, the physical screen is 
scrolled at the same time. 


touchwin(win) 

touchline(win, start, count) 
Throw away all optimization information about which parts of the 
window have been touched, by pretending that the entire window has 
been drawn on. This is sometimes necessary when using overlapping 
windows, since a change to one window affects the other window, but 
the records of which lines have been changed in the other window 
does not reflect the change. touchline() only pretends that count lines 
have been changed, beginning with line start . 


Input 

getch() 

wgetch(win) 

mvgetch(y, x) 

mvwgetch(win, y, x) 
A character is read from the terminal associated with the window. In 
NODELAY mode, if there is no input waiting, the value ERR is 
returned. In DELAY mode, the program hangs until the system passes 
text through to the program. Depending on the setting of cbreak(), 
this is after one character (CBREAK mode), or after the first newline 
(NOCBREAK mode). In HALF-DELAY mode, the program hangs until a 
character 1s typed or the specified timeout has been reached. Unless 
noecho( ) has been set, the character is also echoed into the designated 
window. 


When wegetch() is called, before getting a character, it calls 
wrefresh() if anything in the window has changed (for example, the 
cursor has moved or text changed). 
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When using getch(), wgetch( ), mvgetch( ), or mvwgetch( ), do not set 
both NOCBREAK mode [nocbreak( )] and ECHO mode [echo( )] at the 
same time. Depending on the state of the tty(7) driver when each 
character is typed, the program may produce undesirable results. If 
wegetch( ) encounters a Control-D, it is returned (unlike stdio routines, 
which would return a null string and have a return code of -1). 


If keypad(win, TRUE) has been called, and a function key is pressed, 
the token for that function key is returned instead of the raw 
characters. [See keypad() under ‘“‘Input Options Setting.’’] Possible 
function keys are defined in <curses.h> with integers beginning with 
0401, whose names begin with KEY_. If a character is received that 
could be the beginning of a function key (such as escape), curses sets a 
timer. If the remainder of the sequence is not received within the 
designated time, the character is passed through, otherwise the 
function key value is returned. For this reason, on many terminals, 
there is a delay after a user presses the escape key before the escape is 
returned to the program. [Use by a programmer of the escape key for a 
single character routine is discouraged. Also see notimeout( ) below.] 


Note that getch( ), mvgetch( ), and mvwgetch( ) are macros. 


getstr(str) 

weetstr(win, str) 
mvgetstr(y, x, str) 
mvw¢getstr(win, y, x, str) 


A series of calls to wgetch() is made, until a newline, carriage return, 
or enter key is received. The resulting value (except for this 
terminating character) is placed in the area pointed at by the character 
pointer str. The user’s erase and kill characters are interpreted. See 
wgetch() for how it handles characters differently from stdio routines 
(especially ControlD). 


Note that getstr(), mvgetstr(), and mvwgetstr( ) are macros. 


flushinp() 


Throws away any typeahead that has been typed by the user and has 
not yet been read by the program. Note that flushinp() does not throw 
away any characters supplied by ungetch( ). 


ungetch(c) 


Place c onto the input queue to be returned by the next call to 
wegetch( ). 
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inch( ) 

winch(win) 

mvinch(y, x) 

mvwinch(win, y, x) 
The character, of type chtype, at the current position in the named 
window is returned. If any attributes are set for that position, their 
values are ORed into the value returned. The predefined constants 
A_CHARTEXT and A_ATTRIBUTES, defined in <curses.h>, can be 
used with the C logical AND operator (&) to extract the character or 
attributes alone. 


Note that inch(), winch(), mvinch( ), and mvywinch( ) are macros. 


scanw(fmt [, arg .. .]) 

wscanw(win, fmt [, arg ...]) 

mvscanw(y, x, fmt (, arg ...]) 

mvwscanw(win, y, x, fmt [, arg .. .]) 
These routines correspond to scanf(3S), as do their arguments and 
return values. wgetstr() is called on the window, and the resulting 
line is used as input for the scan. The return value for these routines is 
the number of arg values that are converted by fmt. arg values that are 
not converted are lost. See wgetstr() for how it handles strings 
differently than the stdio routines (especially ControlD). 


vwscanw(win, fmt, ap) 
This routine is similar to vwprintw() in that it performs a wscanw() 
using a variable argument list. The third argument is a va list, a 
pointer to a list of arguments, as defined in <varargs.h>. See the 
yprinif (3S) and varargs(5) manual pages for a detailed description on 
how to use variable argument lists. 


Output Options Setting 
These routines set options within curses that deal with output. All options are 
initially FALSE, unless otherwise stated. It is not necessary to turn these options 
off before calling endwin(). 


clearok(win, bf) 
If enabled (bf is TRUE), the next call to wrefresh() with this window 
clears the screen completely and redraws the entire screen from 
scratch. This is useful when the contents of the screen are uncertain, 
or in some cases for a more pleasing visual effect. 


idlok(win, bf) 
If enabled (bf is TRUE), curses uses the hardware ‘‘insert/delete-line’’ 
feature of terminals so equipped; if disabled (bf is FALSE), curses very 
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seldom uses the hardware ‘‘insert/delete-line’’ feature. (The 
‘“insert/delete-character’’ feature is always considered.) This option 
should be enabled only if your application needs ‘‘insert/delete-line’’, 
for example, for a screen editor. It is disabled by default because 
‘‘insert/delete-line’’ tends to be visually annoying when used in 
applications where it isn’t really needed. If ‘‘insert/delete-line’’ 
cannot be used, curses redraws the changed portions of all lines. Not 
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calling idlok() saves approximately 5000 bytes of memory. 


leaveok(win, bf) 


Normally, the hardware cursor is left at the location of the window 
cursor being refreshed. This option allows the cursor to be left 
wherever the update happens to leave it. It is useful for applications 
where the cursor is not used, since it reduces the need for cursor 
motions. If possible, the cursor is made invisible when this option is 
enabled. 


setscrreg(top, bot) 
wsetscrreg(win, top, bot) 


These routines allow the user to set a software scrolling region in a 
window. top and bot are the line numbers of the top and bottom 
margin of the scrolling region. (Line 0 is the top line of the window.) 
If this option and scrollok() are enabled, an attempt to move off the 
bottom margin line causes all lines in the scrolling region to scroll up 
one line. [Note that this has nothing to do with use of a physical 
scrolling region capability in the terminal, like that in the DEC VT100. 
Only the text of the window is scrolled; if idlok() is enabled and the 
terminal has either a scrolling region or ‘‘insert/delete-line’’ 
capability, they are probably used by the output routines. ] 


Note that setscrreg( ) and wsetscrreg( ) are macros. 


scrollok(win, bf) 


This option controls what happens when the cursor of a window is 
moved off the edge of the window or scrolling region, either from a 
newline on the bottom line, or typing the last character of the last line. 
If disabled (bf is FALSE), the cursor is left on the bottom line at the 
location where the offending character was entered. If enabled (bf is 
TRUE), wrefresh() is called on the window, and then the physical 
terminal and window are scrolled up one line. [Note that in order to 
get the physical scrolling effect on the terminal, it is also necessary to 
call idlok( ).] Note that scrollok( ) always returns OK. 
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Input Options Setting 
These routines set options within curses that deal with input. The options 
involve using ioctl(2) and therefore interact with curses routines. It is not 
necessary to turn these options off before calling endwin(). 


For more information on these options, see UNIX System V Release 3.2 
Programmer's Guide. 


cbreak( ) 
nocbreak( ) 


echoc ) 


These two routines put the terminal into and out of CBREAK mode, 
respectively. In CBREAK mode, characters typed by the user are 
immediately available to the program and _ erase/kill character 
processing is not performed. When in NOCBREAK mode, the tty driver 
buffers characters typed until a newline or carriage return is typed. 
Interrupt and flow-control characters are unaffected by this mode [see 
termio(7)]. Initially, the terminal may or may not be in CBREAK 
mode, as it is inherited, therefore, a program should call cbreak() or 
nocbreak() explicitly. Most interactive programs using curses sets 
CBREAK mode. 


Note that cbreak() performs a subset of the functionality of raw(). 
See wgetch() under ‘‘Input’’ for a discussion of how these routines 
interact with echo( ) and noecho( ). 


noecho( ) 


nl() 


nonl( ) 


These routines control whether characters typed by the user are echoed 
by wgetch() as they are typed. Echoing by the tty driver is always 
disabled, but initially wgetch() is in ECHO mode, so characters typed 
are echoed. Authors of most interactive programs prefer to do their 
own echoing in a controlled area of the screen, or not to echo at all, so 
they disable echoing by calling noecho(). See wgetch() under 
‘‘Input’’ for a discussion of how these routines interact with cbreak( ) 
and nocbreak( ). 


These routines control whether carriage return is translated into 
newline on input by wgetch(). Initially, this translation is done; 
noni() turns the translation off. Note that translation by the tty(7) 
driver is disabled in CBREAK mode. 
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halfdelay(tenths) 
Half-delay mode is similar to CBREAK mode in that characters typed 
by the user are immediately available to the program. However, after 
blocking for tenths tenths of seconds, ERR is returned if nothing has 
been typed. tenths must be a number between 1 and 255. Use 
nocbreak() to leave half-delay mode. 

intrfiush(win, bf) 
If this option is enabled, when an interrupt key is pressed on the 
keyboard (interrupt, break, quit) all output in the tty driver queue is 
flushed, giving the effect of faster response to the interrupt, but 
causing curses to have the wrong idea of what is on the screen. 
Disabling the option prevents the flush. The default for the option is 
inherited from the tty driver settings. The window argument is 
ignored. 


keypad(win, bf) 

This option enables curses to obtain information from the keypad of 
the user’s terminal. If enabled, the user can press a function key (such 
as an arrow key) and wgetch( ) returns a single value representing the 
function key, as in KEY LEFT; if disabled, curses does not treat 
function keys specially and the program would have to interpret the 
escape sequences itself. If the keypad in the terminal can be turned on 
(made to transmit), calling keypad (win, TRUE) enables it. 


meta(win, bf) 

Initially, whether the terminal returns seven or eight significant bits on 
input depends on the control mode of the tty driver [see termio(7)]. To 
force eight bits to be returned, invoke meta (win, TRUE); to force 
seven bits to be returned, invoke meta (win, FALSE). The window 
argument, win, is always ignored. If the terminfo(4) capabilities smm 
(meta_on) and rmm (meta_off) are defined for the terminal, smm is 
sent to the terminal when meta (win, TRUE) 1s called and rmm is sent 
when meta (win, FALSE) is called. 


nodelay(win, bf) 
This option causes wgetch() to be a non-blocking call. If no input is 
ready, wgetch() returns ERR. If disabled, wgetch() hangs until a key 
1S pressed. 

notimeout(win, bf) 
While interpreting an input escape sequence, wgetch() sets a timer 
while waiting for the next character. If notimeout(win, TRUE) is 
called, then wgetch() does not set a timer. The purpose of the timeout 
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is to differentiate between sequences received from a function key and 
those typed by a user. 


raw() 

noraw( ) 
The terminal is placed into or out of raw mode. RAW mode is similar 
to CBREAK mode, in that characters typed are immediately passed 
through to the user program. The differences are that in RAW mode, 
the interrupt, quit, suspend, and flow control characters are passed 
through uninterpreted, instead of generating a signal. The behavior of 
the BREAK key depends on other bits in the tty driver that are not set 
by curses [see termio(7)]. 


typeahead(fildes) 

curses does “‘line-breakout optimization’’ by looking for typeahead 
periodically while updating the screen. If input is found, and it is 
coming from a tty, the current update is postponed until wrefresh( ) or 
doupdate() is called again. This allows faster response to commands 
typed in advance. Normally, the file descriptor for the input FILE 
pointer passed to newterm(), or stdin in the case that initser() was 
used, is used to do this typeahead checking. The typeahead( ) routine 
specifies that the file descriptor fildes is to be used to check for 
typeahead instead. If fildes is -1, then no typeahead checking is 
performed. 


Note that fildes is a file descriptor, not a <stdio.h> FILE pointer. 


Environment Queries 
baudrate( ) 
Returns the output speed of the terminal. The number returned is in 
bits per second, for example, 9600, and is an integer. 


char erasechar( ) 
The user’s current erase character is returned. 
has_ic() 
True if the terminal has insert- and delete-character capabilities. 
has _il() 
True if the terminal has insert- and delete-line capabilities, or can 
simulate them using scrolling regions. This might be used to check to 


see if it would be appropriate to turn on physical scrolling using 
scrollok( ). 


char killchar() 
The user’s current line-kill character is returned. 
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char *longname( ) 
This routine returns a pointer to a static area containing a verbose 
description of the current terminal. The maximum length of a verbose 
description is 128 characters. It is defined only after the call to 
initscr() or newterm(). The area is overwritten by each call to 
newterm( ) and is not restored by set_term(), so the value should be 
saved between calls to newterm( ) if longname() is going to be used 


with multiple terminals. 


Color Manipulation 
This section describes the color manipulation routines introduced in this release 
of curses. 


can_change_color( ) 
This routine requires no arguments. It returns TRUE if the terminal 
supports colors and can change their definitions, FALSE otherwise. 
This routine facilitates writing terminal-independent programs. 


color_content(color, &r, &g, &b) 

This routine gives users a way to find the intensity of the red, green, 
and blue (RGB) components in a color. It requires four arguments: the 
color number, and three addresses of shorts for storing the information 
about the amounts of red, green, and blue components in the given 
color. The value of the first argument must be between 0 and 
COLORS-1. The values that are stored at the addresses pointed to by 
the last three arguments are between 0 (no component) and 1000 
(maximum amount of component). This routine returns ERR if the 
color does not exist (the first argument is outside the valid range), or if 
the terminal cannot change color definitions, OK otherwise. 


has_colors( ) 
This routine requires no arguments. It returns TRUE if the terminal 
can manipulate colors, FALSE otherwise. This routine facilitates 
writing terminal-independent programs. For example, a programmer 
can use it to decide whether to use color or some other video attribute. 


init_color(color, r, g, b) 
This routine changes the definition of a color. It takes four arguments: 
the number of the color to be changed followed by three RGB values 
(for the amounts of red, green, and blue components). (See the section 
COLOR for the default color index.) The value of the first argument 
must be between 0 and COLORS-1. The last three arguments must 
each be a value between 0 and 1000. When init_color() is used, all 
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occurrences of that color on the screen immediately change to the new 
definition. It returns OK if it was able to change the definition of the 
color, ERR otherwise. 


init_pair(pair, f, b) 


This routine changes the definition of a color-pair. It takes three 
arguments: the number of the color-pair to be changed, the foreground 
color number, and the background color number. The value of the first 
argument must be between 1 and COLOR_PAIRS-1. The value of the 
second and third arguments must be between 0 and COLORS-1. If the 
color-pair was previously initialized, the screen are refreshed and all 
occurrences of that color-pair are changed to the new definition. The 
routine returns OK if it was able to change the definition of the color- 
pair, ERR otherwise. 


pair_content(pair, &f, &b) 


This routine allows users to find out what colors a given color-pair 
consists of. It requires three arguments: the color-pair number, and 
two addresses of shorts for storing the foreground and the background 
color numbers. The value of the first argument must be between 1 and 
COLOR _PAIRS-1. The values that are stored at the addresses pointed 
to by the second and third arguments are between 0 and COLORS-1. 
The routine returns ERR if the color_pair has not been initialized, OK 
otherwise. 


start_color( ) 


Soft Labels 


This routine requires no arguments. It must be called if the user wants 
to use colors, and before any other color manipulation routine is 
called. It is good practice to call this routine right after initscr(). 
start_color() initializes eight basic colors (black, blue, green, cyan, 
red, magenta, yellow, and white), and two global variables, COLORS 
and COLOR PAIRS (respectively defining the maximum number of 
colors and color-pairs the terminal can support). It also restores the 
terminal’s colors to the values they had when the terminal was just 
turned on. It returns ERR if the terminal does not support colors, OK 
otherwise. 


If desired, curses manipulates the set of soft function-key labels that exist on 
many terminals. For those terminals that do not have soft labels, if you want to 
simulate them, curses takes over the bottom line of stdscr, reducing the size of 
stdscr and the variable LINES. curses standardizes on eight labels of eight 
Characters each. If a curses program changes the values of the soft labels, it can 
restore them only to the default settings for that terminal. Therefore, if before 
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calling a curses program a user changes the values of the soft labels, those 
values cannot be reset when the curses program terminates. 


slk_init(labfmt) 
In order to use soft labels, this routine must be called before initscr( ) 
or newterm( ) is called. If initscr() winds up using a line from stdscr 
to emulate the soft labels, then Jabfmt determines how the labels are 
arranged on the screen. Setting labfmt to 0 indicates that the labels are 
to be arranged in a 3-2-3 arrangement; 1 asks for a 4-4 arrangement. 


slk_set(labnum, label, labfmt) 
labnum is the label number, from 1 to 8. label is the string to be put on 
the label, up to eight characters in length. A NULL string or a NULL 
pointer puts up a blank label. /abfmt is one of 0, 1 or 2, to indicate 
whether the label is to be left-iustified, centered, or right-justified 
within the label. 


slk_refresh( ) 

sik_noutrefresh( ) 
These routines correspond to the routines wrefresh() and 
wnoutrefresh(). Most applications would use sik_noutrefresh( ) 
because a wrefresh( ) is likely to follow soon. 


char *slk_label(labnum) 
The current label for label number /abnum is returned, in the same 
format as it was in when it was passed to slk_set(); that is, how it 
looked prior to being justified according to the labfmt argument of 
sik set(). 


slk_clear() 
The soft labels are cleared from the screen. 


sik restore() 
The soft labels are restored to the screen after a slk_clear(). 


slk_touch() 
All of the soft labels are forced to be output the next time a 
slk_noutrefresh( ) is performed. 


slk_attron(attrs) 

sIk_attrset(attrs) 

sik_attrof(attrs) 
These routines correspond to attron(), attrset(), and attrof(). The 
have effect only if soft labels are simulated at the bottom of the screen. 
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Low-Level curses Access 

The following routines give low-level access to various curses functionality. 

These routines typically would be used inside of library routines. 

def_ prog mode() 

def_shell_mode( ) 
Save the current terminal modes as the ‘‘program’’ (in curses) or 
“‘shell’” (not in curses) state for use by the reset_prog_mode() and 
reset shell_ mode( ) routines. This is done automatically by initscr‘( ). 


¢ 


reset prog mode( ) 

reset _shell_mode( ) 
Restore the terminal to “‘program’’ Gn curses) or ‘‘shell’’ (out of 
curses) state. These are done automatically by endwin() and 
doupdate( ) after an endwin(), so they normally would not be called. 


resetty( ) 

savetty() 
These routines save and restore the state of the terminal modes. 
savetty() saves the current state of the terminal in a buffer and 
resetty() restores the state to what it was at the last call to savetty(). 


getsyx(y, x) 
The current coordinates of the virtual screen cursor are returned in y 
and x. If leaveok() is currently TRUE, then -1,-1 is returned. If lines 
have been removed from the top of the screen using ripoffline( ), y and 
x include these lines; therefore, y and x should be used only as 
arguments for setsyx( ). 


Note that getsyx() is a macro, so no & is necessary before the 
variables y and x. 


setsyx(y, x) 

The virtual screen cursor is set to y, x. If y and x are both -1, then 
leaveok( ) is set. The two routines getsyx() and setsyx() are designed 
to be used by a library routine which manipulates curses windows but 
does not want to change the current position of the program’s cursor. 
The library routine would call getsyx() at the beginning, do its 
manipulation of its own windows, do a wnoutrefresh() on its 
windows, call setsyx(), and then call doupdate( ). 


ripoffline(line, init) 
This routine provides access to the same facility that slk_init() uses to 
reduce the size of the screen. ripoffline() must be called before 
initscr( ) or newterm( ) is called. If line is positive, a line is removed 
from the top of stdscr; if negative, a line is removed from the bottom. 
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When this is done inside initscr(), the routine init() 1s called with two 
arguments: a window pointer to the one-line window that has been 
allocated and an integer with the number of columns in the window. 
Inside this initialization routine, the integer variables LINES and COLS 
(defined in <curses.h>) are not guaranteed to be accurate and 
wrefresh( ) or doupdate() must not be called. It is allowable to call 
wnoutrefresh( ) during the initialization routine. ripoffline() can be 
called up to five times before calling initscr( ) or newterm( ). 


scr_dump(filename) 


The current contents of the virtual screen are written to the file 
filename. 


scr_restore(filename) 


The virtual screen is set to the contents of filename , which must have 
been written using scr dump(). ERR is returned if the contents of 
filename are not compatible with the current release of curses 
software. The next call to doupdate() restores the screen to what it 
looked like in the dump file. 


scr_init(filename) 


The contents of filename are read in and used to initialize the curses 
data structures about what the terminal currently has on its screen. If 
the data is determined to be valid, curses bases its next update of the 
screen on this information rather than clearing the screen and starting 
from scratch. scr_init() would be used after initscr() or a system(3S) 
call to share the screen with another process which has done a 
scr_dump() after its endwin() call. The data is declared invalid if the 
time-stamp of the tty is old or the terminfo (4) capability nrrmc is true. 
Note that keypad(), meta(), sik clear(), curs set(), flash(), and 
beep() do not affect the contents of the screen, but makes the tty’s 
time-stamp old. 


curs set(visibility) 


The cursor is set to invisible, normal, or very visible for visibility equal 
to 0, 1 or 2. If the terminal supports the visibility requested, the 
previous cursor state is returned; otherwise, ERR is returned. 


draino(ms) 


Wait until the output has drained enough that it takes only ms more 
milliseconds to drain completely. 


garbagedlines(win, begline, numlines) 


This routine indicates to curses that a screen line is garbaged and 
should be thrown away before having anything written over the top of 
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it. It could be used for programs such as editors which want a 
command to redraw just a single line. Such a command could be used 
in cases where there is a noisy communications line and redrawing the 
entire screen would be subject to even more communication noise. 
Just redrawing the single line gives some semblance of hope that it 
would show up unblemished. The current location of the window is 
used to determine which lines are to be redrawn. 


napms(ms) 
Sleep for ms milliseconds. mvcur(oldrow, oldcol, newrow, newcol) 
Low-level cursor motion. 


Terminfo-Level Manipulations 
These low-level routines must be called by programs that need to deal directly 
with the terminfo (4) database to handle certain terminal capabilities, such as 
programming function keys. For all other functionality, curses routines are 
more suitable and their use is recommended. 


Initially, setupterm() should be called. [Note that setupterm() is 
automatically called by initscr() and newterm().] This defines the set of 
terminal-dependent variables defined in the terminfo(4) database. The 
terminfo(4) variables lines and columns [see terminfo(4)] are initialized by 
setupterm() as follows: if the environment variables LINES and COLUMNS 
exist, their values are used. If the above environment variables do not exist, the 
values for lines and columns specified in the terminfo (4) database are used. 


The header files <curses.h> and <term.h> should be included, in this order, to 
get the definitions for these strings, numbers, and flags. Parameterized strings 
should be passed through tparm() to instantiate them. All terminfo (4) strings 
[including the output of tparm()] should be printed with tputs() or putp(). 
Before exiting, reset_shell_mode() should be called to restore the tty modes. 
Programs that use cursor addressing should output enter_ca_mode upon startup 
and should output exit_ca_mode before exiting [see terminfo(4)]. Programs 
that use shell escapes should call reset_shell mode() and output 
exit_ca_mode before the shell is called and should output enter_ca_mode and 
call reset_prog_mode() after returning from the shell. Note that this is 
different from the curses routines [see endwin( )]. 


setupterm(term, fildes, errret) 
Reads in the terminfo(4) database, initializing the terminfo(4) 
structures, but does not set up the output virtualization structures used 
by curses. The terminal type is in the character string term; if term is 
NULL, the environment variable TERM is used. All output is to the 
file descriptor fildes. If errret is not NULL, then setupterm( ) returns 


2312 


CURSES (3X) 


CURSES (3X) 


OK or ERR and store a status value in the integer pointed to by errret. 
A Status of 1 in errret is normal, 0 means that the terminal could not be 
found, and -1 means that the terminfo (4) database could not be found. 
If errret is NULL, setupterm() prints an error message upon finding 
an error and exit. Thus, the simplest call is setupterm [(char *)0, 1, 
(int *)0], which uses all the defaults. 


The terminfo(4) boolean, numeric and string variabies are siored in a 
structure of type TERMINAL. After setupterm( ) returns successfully, 
the variable cur_term (of type TERMINAL *) is initialized with all of 
the information that the terminfo(4) boolean, numeric and string 
variables refer to. The pointer can be saved before cailing 
setupterm() again. Further calls to setupterm( ) allocates new space 
rather than reuse the space pointed to by cur_term. 


set_curterm(nterm) 


nierm is of type TERMINAL *. set_curterm() sets the variable 
cur_term to nterm, and makes all of the terminfo (4) boolean, numeric 
and string variables use the values from nterm. 


del_curterm(oterm) 


oterm is of type TERMINAL *. del_curterm( ) frees the space pointed 
to by ofterm and makes it available for further use. If oterm is the same 
as cur_term, then references to any of the terminfo(4) boolean, 
numeric and string variables thereafter may refer to invalid memory 
locations until another setupterm( ) has been called. 


restartterm(term, fildes, errret) 


Similar to setupterm(), except that it is called after restoring memory 
to a previous state; for example, after a call to scr_restore(). It 
assumes that the windows and the input and output options are the 
same as when memory was saved, but the terminal type and baud rate 
may be different. 


char +tparm(str, p,P,, ---s Pg) 


Instantiate the string str with parms p.. A pointer is returned to the 
result of str with the parameters applied. 


tputs(str, count, putc) 


Apply padding to the string str and output it. str must be a terminfo (4) 
string variable or the return value from tparm(), tgetstr(), tigetstr() 
or tgoto(). count is the number of lines affected, or 1 if not applicable. 
putc() is a putchar (3S)-like routine to which the characters are passed, 
one at a time. 
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putp(str) 
A routine that calls tputs [stv, 1, putchar( )]. 


vidputs(attrs, putc) 
Output a string that puts the terminal in the video attribute mode attrs, 
which is any combination of the attributes listed below. The 
characters are passed to the putchar (3S)-like routine putc (). 


vidattr(attrs) 
Like vidputs( ), except that it outputs through putchar (3S). 


The following routines return the value of the capability corresponding to the 
character string containing the terminfo(4) capname passed to them. For 
example, re = tigetstr("acsc") causes the value of acsc to be returned in re. 


tigetflag(capname) 
The value -1 is returned if capname is not a boolean capability. The 
value 0 is returned if capname is not defined for this terminal. 


tigetnum(capname) 
The value -2 is returned if capname is not a numeric capability. The 
value -1 is returned if capname is not defined for this terminal. 


tigetstr(capname) 
The value (char *) -1 is returned if capname is not a string capability. 
A null value is returned if capname is not defined for this terminal. 


char *boolnames[ |, *boolcodes|[ |, *boolfnames| | 

char *numnames[ ], *numcodes[ |], *numfnames{ ] 

char *strnames[ ], *strcodes[ ], *strfnames| ] 
These nulj-terminated arrays contain the capnames, the termcap codes, 
and the full C names, for each of the terminfo (4) variables. 


Termcap Emulation 
These routines are included as a conversion aid for programs that use the 
termcap library. Their parameters are the same and the routines are emulated 
using the terminfo (4) database. 


tgetent(bp, name) 
Look up termcap entry for name. The emulation ignores the buffer 
pointer bp. 


tgetflag(codename) 
Get the boolean entry for codename. 


tgetnum(codes) 
Get numeric entry for codename. 
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char *tgetstr(codename, area) 
Return the string entry for codename. If area is not NULL, then also 
store it in the buffer pointed to by area and advance area. tputs() 
should be used to output the returned string. 


char *tgoto(cap, col, row) 
Instantiate the parameters into the given capability. The output from 
this routine is to be passed to tputs(). 

tputs(str, affcnt, putc) 
See tputs() above, in this section. 


Miscellaneous 
unctrI(c) 
This macro expands to a character string which is a printable 


; 
representation of the character c. Control characters are displayed in 


the Control X notation. Printing characters are displayed as is. 


unctrI() is a macro, defined in <unctrl.h>, which is automatically 
included by <curses.h>. 


char *keyname(c) 
A character string corresponding to the key c is returned. 


filter() This routine is one of the few that is to be called before initscr() or 
newterm( ) is called. It arranges things so that curses thinks that there 
is a one-line screen. curses does not use any terminal capabilities that 
assume that they know what line on the screen the cursor is on. 


Use of curscr 

The special window curscr can be used in only a few routines. If the window 
argument to clearok( ) is curscr, the next call to wrefresh() with any window 
causes the screen to be cleared and repainted from scratch. If the window 
argument to wrefresh() is curscr, the screen is immediately cleared and 
repainted from scratch. (This is how most programs would implement a 
‘‘repaint-screen’’ routine.) The source window argument to overlay(), 
overwrite( ), and copywin() may be curscr, in which case the current contents 
of the virtual terminal screen is accessed. 
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Obsolete Calls 
Various routines are provided to maintain compatibility in programs written for 
older versions of the curses library. These routines are all emulated as indicated 
below. 


crmode( ) Replaced by cbreak(). 

fixterm( ) Replaced by reset_prog mode( ). 
gettmode() A no-op. 

nocrmode() Replaced by nocbreak(). 
resetterm() Replaced by reset _shell_ mode‘). 
saveterm() Replaced by def_prog_ mode(). 
setterm( ) Replaced by setupterm( ). 


ATTRIBUTES 
The following video attributes, defined in <curses.h>, can be passed to the 
routines wattron(), wattroff(), and wattrset(), or ORed with the characters 
passed to waddch( ). 


A_STANDOUT Terminal’s best highlighting mode 
A_UNDERLINE Underlining 


A_REVERSE Reverse video 

A_BLINK Blinking 

A_DIM Half bright 

A_BOLD Extra bright or bold 

A_ALTCHARSET _ Alternate character set 

COLOR_PAIR Color-pair defined in n (note that this is a macro) 

A_CHARTEXT Bit-mask to extract character 
[described under winch( )] 

A_ATTRIBUTES Bit-mask to extract attributes 
[described under winch( )] 

A_NORMAL Bit mask to reset all attributes off 
[for example: attrset (A_NORMAL)] 

A_COLOR Extract color-pair field information 


FUNCTION-KEYS 
The following function keys, defined in <curses.h>, might be returned by 
getch() if keypad() has been enabled. Note that not all of these can be 
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supported on a particular terminal if the terminal does not transmit a unique 
code when the key is pressed or the definition for the key is not present in the 


terminfo (4) database. 


Name 


KEY BREAK 
KEY_DOWN 
KEY_UP 
KEY_LEFT 
KEY_RIGHT 
KEY_HOME 


KEY_BACKSPACE 
KEY_FO 


KEY_F(n) 


KEY_DL 
KEY_IL 
KEY_DC 
KEY_IC 


KEY_EIC 
KEY_CLEAR 
KEY_EOS 
KEY_EOL 
KEY_SF 
KEY_SR 


KEY_NPAGE 
KEY_PPAGE 
KEY_STAB 
KEY_CTAB 
KEY_CATAB 
KEY_ENTER 
KEY_SRESET 
KEY_RESET 


Value 


0401 
0402 
0403 
0404 
0405 
0406 


0407 
0410 


{[KEY_FO 
+(n)] 
0510 
0511 
0512 
0513 


0514 
0515 
0516 
0517 
0520 
0521 


0522 
0523 
0524 
0525 
0526 
0527 
0530 
0531 


Key name 


Break key (unreliable) 
The four arrow keys... 


Home key (upward+left 
arrow) 

Backspace (unreliable) 
Function keys. Space for 
64 keys is reserved. 
Formula for f n° 


Delete line 

Insert line 

Delete character 

Insert char or enter insert 
mode 

Exit insert char mode 
Clear screen 

Clear to end of screen 
Clear to end of line 
Scroll one line forward 
Scroll one line backwards 
(reverse) 

Next page 

Previous page 

Set tab 

Clear tab 

Clear all tabs 

Enter or send 

Soft (partial) reset 

Reset or hard reset 
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KEY_PRINT 0532 Print or copy 
KEY_LL 0533 Home down or bottom (lower- 
left). 
Keypad is arranged 
like this: 
Al up A3 
left B2 right 
Cl down C3 
KEY_A! 0534 Upper left of keypad 
KEY_A3 0535 Upper right of keypad 
KEY_B2 0536 Center of keypad 
KEY_Cl 0537 Lower left of keypad 
KEY_C3 0540 Lower right of keypad 
KEY_BTAB 0541 Back tab key 
KEY _BEG 0542 Beg(inning) key 
KEY_CANCEL 0543 Cancel key 
KEY_CLOSE 0544 Close key 
KEY_COMMAND 0545 Cmd (command) key 
KEY_COPY 0546 Copy key 
KEY_CREATE 0547 Create key 
KEY_END 0550 End key 
KEY_EXIT 0551 Exit key 
KEY_FIND 0552 Find key 
KEY_HELP 0553 Help key 
KEY_MARK 0554 Mark key 
KEY_MESSAGE 0555 Message key 
KEY_MOVE 0556 Move key 
KEY_NEXT 0557 Next object key 
KEY_OPEN 0560 Open key 
KEY_OPTIONS 0561 Options key 
KEY_PREVIOUS 0562 Previous object key 
KEY_REDO 0563 Redo key 
KEY_REFERENCE 0564 Ref(erence) key 
KEY_REFRESH 0565 Refresh key 
KEY_REPLACE 0566 Replace key 
KEY_RESTART 0567 Restart key 
KEY_RESUME 0570 Resume key 
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KEY_SAVE 
KEY_SBEG 
KEY_SCANCEL 
KEY_SCOMMAND 
KEY_SCOPY 
KEY_SCREATE 
KEY_SDC 
KEY_SDL 
KEY_SELECT 
KEY_SEND 
KEY_SEOL 
KEY_SEXIT 
KEY_SFIND 
KEY_SHELP 
KEY_SHOME 
KEY_SIC 
KEY_SLEFT 
KEY_SMESSAGE 
KEY_SMOVE 
KEY_SNEXT 
KEY_SOPTIONS 
KEY_SPREVIOUS 
KEY_SPRINT 
KEY_SREDO 
KEY_SREPLACE 
KEY_SRIGHT 
KEY_SRSUME 
KEY_SSAVE 
KEY_SSUSPEND 
KEY_SUNDO 
KEY_SUSPEND 
KEY_UNDO 


LINE GRAPHICS 


0571 
0572 
0573 
0574 
0575 
0576 
OS77 
0600 
0601 
0602 
0603 
0604 
0605 
0606 
0607 
0610 
0611 
0612 
0613 
0614 
0615 
0616 
0617 
0620 
0621 
0622 
0623 
0624 
0625 
0626 
0627 
0630 
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Save key 

Shifted beginning key 
Shifted cancel key 
Shifted command key 
Shifted copy key 
Shifted create key 
Shifted delete char key 
Shifted delete line key 
Select key 

Shifted end key 
Shifted clear line key 
Shifted exit key 
Shifted find key 
Shifted help key 
Shifted home key 
Shifted input key 
Shifted left arrow key 
Shifted message key 
Shifted move key 
Shifted next key 
Shifted options key 
Shifted prev key 
Shifted print key 
Shifted redo key 
Shifted replace key 
Shifted right arrow 
Shifted resume key 
Shifted save key 
Shifted suspend key 
Shifted undo key 
Suspend key 

Undo key 


The following variables can be used to add line-drawing characters to the 
screen with waddch(). When defined for the terminal, the variable has the 
A ALTCHARSET bit enabled; otherwise, the default charcter listed below is 
stored in the variable. The names were chosen to be consistent with the DEC 


VT100 nomenclature. 
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Name 


ACS_ULCORNER 
ACS_LLCORNER 
ACS_URCORNER 
ACS_LRCORNER 
ACS_RTEE 
ACS_LTEE 
ACS_BTEE 
ACS_TTEE 
ACS_HLINE 
ACS_VLINE 
ACS_PLUS 
ACS_S1 

ACS_S9 
ACS_DIAMOND 
ACS_CKBOARD 
ACS_DEGREE 
ACS_PLMINUS 
ACS_BULLET 
ACS_LARROW 
ACS_RARROW 
ACS_DARROW 
ACS_UARROW 
ACS_BOARD 
ACS_LANTERN 
ACS_BLOCK 


RETURN VALUES 


Default 


+ 
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Glyph Description 


upper-left corner 
lower-left corner 
upper-right corner 
lower-right comer 
right tee (4) 

lett tee (+) 

bottom tee ( | ) 

top tee (7) 
horizontal line 
vertical line 

plus 

scan line 1 

scan line 9 

diamond 

checker board (stipple) 
degree symbol 
plus/minus 

bullet 

alrow pointing left 
arrow pointing night 
arrow pointing down 
alrow pointing up 
board of squares 
lantern symbol 
solid square block 


All routines return the integer OK upon successful completion and the integer 
ERR upon failure, unless otherwise noted in the preceding routine descriptions. 


All macros return the value of their w version, except getsyx(), getyx(), 
getbegyx( ), getmaxyx(). For these macros, no useful value is returned. 


Routines that return pointers always return (type *) NULL on error. 


SEE ALSO 


cc(1), Id(1), ioctl(2), plot(3X), putc(3S), scanf(3S), stdio(3S), system(3S), 
vprintf{(3S), profile(4), term(4), terminfo(4), varargs(5), termio(7). 
UNIX System V Release 3.2 Programmer's Guide. 


- 39 - 


CURSES(3X) CURSES (3X) 


WARNINGS 


BUGS 


To use the new curses features, use the version of curses on CTIX Releases 6.1 
and higher. All programs that ran curses under CTIX releases prior to 6.1 will 
run with CTIX Release 6.1. You can link applications with object files based on 
the previous curses/terminfo with the CTIX 6.1 libcurses.a library. You can link 
applications with object files based on the CTIX 6.1 curses/terminfo with 
previous CTIX releases’ libcurses.a libraries, so long as the application does not 
use the new features in the CTIX 6.1 curses/terminfo. 


The plotting library plot(3X) and the curses library curses(3X) both use the 
names erase() and move(). The curses versions are macros. If you need both 
libraries, put the plot(3X) code in a different source file than the curses(3X) 
code, and/or #undef move( ) and erase() in the plot(3X) code. 


Between the time a call to initscr() and endwin() has been issued, use only the 
routines in the curses library to generate output. Using system calls or the 
‘*standard I/O package’’ [see stdio(3S)] for output during that time can cause 
unpredictable results. 


If a pointer passed to a routine as a window argument is null or out of range, the 
results are undefined (core may be dumped). 


Currently typeahead checking is done using a nodelay read followed by an 
ungetch() of any character that may have been read. Typeahead checking is 
done only if wgetch() has been called at least once. This will be changed when 
proper kernel support is available. Programs which use a mixture of their own 
input routines with curses input routines may wish to call typeahead(-1) to turn 
off typeahead checking. The argument to napms() is currently rounded up to 
the nearest second. 


draino (ms) only works for ms equal to 0. 
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NAME 
cuserid - get character login name of the user 


SYNOPSIS 
#include <stdio.h> 


char *cuserid (s) 
char *s; 


DESCRIPTION 

The cuserid routine gets the user’s login name as found in /etc/utmp. If the 
login name cannot be found, cuserid gets the login name corresponding to the 
user ID of the current process. If s is a NULL pointer, this representation is 
generated in an internal static area, the address of which is returned. Otherwise, 
s 1S assumed to point to an array of at least L_cuserid characters; the 
representation is left im this array. The consiant L_cuserid is defined in the 
<stdio.h> header file. 


SEE ALSO 
getlogin(3C), getpwent(3C). 


DIAGNOSTICS 
If the login name cannot be found, cuserid returns a NULL pointer; if s is not a 
NULL pointer, a null character (\0) will be placed at s/0/. 
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NAME 
dbminit, fetch, store, delete, firstkey, nextkey - database subroutines 


SYNOPSIS 
#include <dbm.h> 


typedef struct { 
char *dptr; 
int dsize; 

} datum; 

dbminit(file) 

char *file; 


datum fetch(key) 
datum key; 


store(key, content) 
datum key, content; 


delete(key) 
datum key; 


datum firstkey( 


datum nextkey(key) 
datum key; 


DESCRIPTION 
The dbm functions maintain key/content pairs in a database. The functions 
handle very large (a billion blocks) databases and access a keyed item in one or 
two file system accesses. The functions are obtained with the loader option 
-ldbm. 


keys and contents are described by the datum typedef. A datum specifies a 
string of dsize bytes pointed to by dptr. Arbitrary binary data, as well as normal 
ASCII strings, are allowed. The database is stored in two files. One file is a 
directory containing a bit map and has .dir as its suffix. The second file 
contains all data and has .pag as its suffix. 


Before a database can be accessed, it must be opened by dbminit. At the time of 
this call, the files file.dir and file.pag must exist. (An empty database is 
Once open, the data stored under a key is accessed by fetch and data is placed 
under a key by store. A key (and its associated contents) is deleted by delete. 
A linear pass through all keys in a database can be made, in an (apparently) 
random order, by use of firstkey and nextkey: firstkey returns the first key in the 
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database; with any key nextkey returns the next key in the database. This code 
traverses the database: 


for (key = firstkey(); key.dptr != NULL; key = nextkey(key) 


SEE ALSO 


ndbm(3X). 


DIAGNOSTICS 


NOTE 


All functions that return an int indicate errors with negative values. A zero 
return indicates ok. Routines that return a datum indicate errors with a null (0) 


dptr. 


The dbm library has been superseded by ders and is now implemented 


sense AL... rw a saantliwaAnd Frew anemant sth avictina nenanramo that 
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invoke dbm(3X). When writing new programs, use ndbm(3X) instead. 


WARNINGS 


The .pag file contains holes so that its apparent size is about four times its 
actual content. Older UNIX systems can create real file blocks for these holes 
when touched. These files cannot be copied by normal means (cp, cat, tp, tar 
ar) without filling in the holes. 


dptr pointers returned by these subroutines point into static storage that is 
changed by subsequent calls. 


The sum of the sizes of a key/content pair must not exceed the internal block 
size (currently 1024 bytes). Moreover all key/content pairs that hash together 
must fit on a single block. store returns an error in the event that a disk block 
fills with inseparable data. 


delete does not physically reclaim file space, although it does make it available 
for reuse. 


The order of keys presented by firstkey and nextkey depends on a hashing 
function, not on anything interesting. 
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NAME 


DIAL(3C) 


dial - establish an out-going terminal line connection 


SYNOPSIS 
Finclude <dial.h> 


int dial (call) 
CALL call; 


void undial (fd) 
int fd; 


DESCRIPTION 


The dial routine returns a file-descriptor for a terminal line open for read/write. 
The argument to dial is a CALL structure (defined in the <dial.h> header file). 


When finished with the terminal line, the calling program must invoke undial to 
release the semaphore that has been set during the allocation of the terminal 


device. 


The definition of CALL in the <dial.h> header file is as follows: 


typedef struct { 
struci termio «attr; 


int baud; 
int speed; 
char *[Ine; 
char *teino; 
int modem; 
char *device; 
int dev len; 
} CALL; 


/* pointer to termio attribute 
struct */ 

/+ transmission data rate +/ 

{x 242A modem: tow=300, 
high=1200 (unused) «/ 

/+* device name for out-going line */ 

/* pointer to tel-no digits string +/ 

/* specify modem control for direct 
lines +/ 

/« Will hold the name of the device 
used to make a connection 
(unused) */ 

/+* The length of the device used to 
make connection (unused) +/ 


The CALL element baud is for the desired transmission baud rate. The rate must 
be one of those supported by the operating system (134.5 is rounded to 134). If 
the baud is less than 300, the line will be dialed at 300 baud then switched to 
the desired rate (unless attr is non-null; see below). 


If a particular terminal line is desired, a string pointer to its device-name should 
be placed in the line element in the CALL structure. Legal values for such 
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FILES 


terminal device names are kept in /usr/lib/uucp/Devices. In this case, if baud is 
0, the speed used will be determined by the line in the Devices file for the 
terminal device. 


The telno element is for a pointer to a character string representing the 
telephone number to be dialed. Numbers consist of the following symbols: 


0-9 dial 0-9 

+ dial * 

# dial # 

- 4-second delay for second dial tone 


= wait for secondary dial tone 


On a smart modem, these symbols are translated to modem commands using the 
modem description in /usr/lib/uucp/Dialers. 


If telno is specified, an ACU entry in the Devices file will be used. If it 1s NULL, 
a Direct entry will be used. 


The CALL element modem is used to specify modem control for direct lines. 
This element should be non-zero if modem control is required. 


The CALL element attr is a pointer to a fermio structure, as defined in the 
termio.h header file. A NULL value for this pointer element may be passed to 
the dial function, but if such a structure is included, the elements specified in it 
will be set for the outgoing terminal line before the connection is established. 
This is often important for certain attributes such as parity and baud-rate. 
Values in this structure override the baud and modem entries. 


Information on 801 type dialing units is obtained from the Devices file; thus the 
speed, device and dev _len elements are no longer used. 


/usr/lib/uucp/Devices 
/usr/lib/uucp/Dialers 
/usr/spool/locks/LCK. .tty-device 


SEE ALSO 


uucp(1C), alarm(2), read(2), write(2), Devices(5), Dialers(5), termio(7). 


DIAGNOSTICS 


On failure, a negative value indicating the reason for the failure will be 
returned. Mnemonics for these negative indexes as listed here are defined in 
the <dial.h> header file. 


INTRPT  -1 /* interrupt occurred *+/ 
D HUNG -2 /* dialer hung (no return from write) */ 
NO ANS -3 /* no answer within 10 seconds */ 


-9- 
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It BD -4 /* illegal baud-rate «/ 

A_PROB -5 /* acu problem (open() failure) +/ 

L_ PROB -6 /* line problem (open() failure) */ 

NO idv -7 /« can't open LDEVS file +/ 

DV_NTA -8 /* requested device not available +/ 
DV_NT K -9 /* requested device not known */ 

NO BD A -10 /« no device available at requested baud +/ 
NO_BD K -11 /* no device known at requested baud +/ 


WARNINGS 


BUGS 


Including the <dial.h> header file automatically includes the <termio.h> 
header file. 


The above routine uses <stdio.h>, which causes it to increase the size of 
programs, not otherwise using standard /O, more than might be expected. 


An alarm(2) system call for 3600 seconds is made (and caught) within the dial 
module for the purpose of ‘“‘touching’’ the LCK.. file and constitutes the device 
allocation semaphore for the terminal device. Otherwise, uucp(1C) may simply 
delete the LCK.. entry on its 90-minute clean-up rounds. The alarm may go off 
while the user program is in a read(2) or write(2) system call, causing an 
apparent error return. If the user program expects to be around for an hour or 
more, error returns from reads should be checked for (errno==EINTR), and the 
read possibly reissued. 
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NAME 
directory: opendir, readdir, telldir, seekdir, rewinddir, closedir - directory 
operations 


SYNOPSIS 
#include <sys/types.h> 
#include <dirent.h> 


DIR *opendir (filename) 
char *filename; 


struct dirent *readdir (dirp) 
DIR *dirp; 


long telldir (dirp) 
DIR +#dirp; 


void seekdir (dirp, loc) 
DIR *dirp; 
long loc; 


void rewinddir (dirp) 
DIR *dirp; 


void closedir(dirp) 
DIR *dirp; 


DESCRIPTION 
The opendir routine opens the directory named by filename and associates a 
directory stream with it. The opendir routine returns a pointer to be used to 
identify the directory stream in subsequent operations. The pointer NULL is 
returned if filename cannot be accessed or is not a directory, or if it cannot 
malloc(3X) enough memory to hold a DIR structure or a buffer for the directory 
entries. 


The readdir routine returns a pointer to the next active directory entry. No 
inactive entries are returned. It returns NULL upon reaching the end of the 
directory or upon detecting an invalid location in the directory. 


The telldir routine returns the current location associated with the named 
directory stream. 


The seekdir routine sets the position of the next readdir operation on the 
directory stream. The new position reverts to the one associated with the 
directory stream when the telldir operation from which loc was obtained was 
performed. Values returned by telldir are good only if the directory has not 
changed due to compaction or expansion. This is not a problem with System V, 
but it may be with some file system types. 


ite 
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The rewinddir routine resets the position of the named directory stream to the 
beginning of the directory. 


The closedir routine closes the named directory stream and frees the DIR 
structure. 


The following errors can occur as a result of these operations. 


opendir : 

[ENOTDIR] A component of filename is not a directory. 

[EACCES] A component of filename denies search permission. 

[EMFILE] The maximum number of file descriptors are currently open. 

[EFAULT] Filename points outside the allocated address space. 

readdir : 

[ENOENT] The current file pointer for the directory is not located at a 
valid entry. 

[EBADF] The file descriptor determined by the DIR stream is no longer 


valid. This results if the DIR stream has been closed. 
telldir, seekdir, and closedir: 


[EBADF] The file descriptor determined by the DIR stream is no longer 
valid. This results if the DIR stream has been closed. 
EXAMPLE 
Sample code which searches a directory for entry name: 
dirp = opendir( ".” ); 
while ( (dp = readdir( dirp )) != NULL ) 
if ( strcemp{ dp->d_name, name ) == 0 ) 


{ 
closedir( dirp ); 
return FOUND; 
} 
closedir( dirp ); 
return NOT_FOUND; 
SEE ALSO 
getdents(2), dirent(4). 
WARNINGS 
The rewinddir routine is implemented as a macro, so its function address cannot 
be taken. 
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NAME 
drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, 
Icong48 - generate uniformly distributed pseudo-random numbers 

SYNOPSIS 
double drand48 ( ) 


double erand48 (xsubi) 
unsigned short xsubi(3]; 


long lrand48 ( ) 


long nrand48 (xsubi) 
unsigned short xsubi[3]; 


long mrand48 ( ) 


iong jrand48 (xsubi) 
unsigned short xsubi[3); 


void srand48 (seedval) 
long seedval; 


unsigned short *seed48 (seed16v) 
unsigned short seed16v[3]; 


void Icong48 (param) 
unsigned short param(7]; 


DESCRIPTION 
This family of functions generates pseudo-random numbers using the well- 
known linear congruential algorithm and 48-bit integer arithmetic. 


Functions drand48 and erand48 return non-negative double-precision 
floating-point values uniformly distributed over the interval [0.0, 1.0). 


Functions /rand48 and nrand48 return non-negative long integers uniformly 
distributed over the interval [0, 27'). 


Functions mrand48 and jrand48 return signed long integers uniformly 
distributed over the interval [—23! , 23). 


Functions srand48, seed48 and Icong48 are initialization entry points, one of 
which should be invoked before either drand48, lrand48 or mrand48 is called. 
(Although it is not recommended practice, constant default initializer values 
will be supplied automatically if drand48, lrand48 or mrand48 is called 
without a prior call to an initialization entry point.) Functions erand48, 
nrand48 and jrand48 do not require an initialization entry point to be called 
first. 
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All the routines work by generating a sequence of 48-bit integer values, X;, 
according to the linear congruential formula: 


Xn4l = (aX, + C mod m n20. 


The parameter m = 28; hence 48-bit integer arithmetic is performed. Unless 
Icong48 has been invoked, the multiplier value a and the addend value c are 


given by: 
a = SDEECE66D 1, = 273673163155 g 
c=B 146 = 13 8- 


The value returned by any of the functions drand48, erand48, lrand48, 
nrand48, mrand48 or jrand48 is computed by first generating the next 48-bit X; 
in the sequence. Then the appropriate number of bits, according to the type of 
data item to be returned, are copied from the high-order (leftmost) bits of X; and 
transformed into the returned value. 


The functions drand48, lrand48 and mrand48 store the last 48-bit X; generated 
in an internal buffer, and must be initialized prior to being invoked. The 
functions erand48, nrand48 and jrand48 require the calling program to provide 
storage for the successive X; values in the array specified as an argument when 
the functions are invoked. These routines do not have to be initialized; the 
calling program must place the desired initial value of X; into the array and pass 
it aS an argument. By using different arguments, functions erand48, nrand48 
and jrand48 allow separate modules of a large program to generate several 
independent streams of pseudo-random numbers, that is, the sequence of 
numbers in each stream will not depend upon how many times the routines 
have been called to generate numbers for the other streams. 


The initializer function srand48 sets the high-order 32 bits of X; to the 32 bits 
contained in its argument. The low-order 16 bits of X; are set to the arbitrary 
value 330Ej¢. 


The initializer function seed48 sets the value of X; to the 48-bit value specified 
in the argument array. In addition, the previous value of X; is copied into a 48- 
bit internal buffer, used only by seed48, and a pointer to this buffer is the value 
retumed by seed48. This returned pointer, which can just be ignored if not 
needed, is useful if a program is to be restarted from a given point at some 
future time — use the pointer to get at and store the last X; value, and then use 
this value to reinitialize via seed48 when the program is restarted. 


The initialization function /cong48 allows the user to specify the initial X;, the 
multiplier value a, and the addend value c. Argument array elements 
param[0-2] specify X;, param[3-5] specify the multiplier a, and param([6] 
specifies the 16-bit addend c. After Icong48 has been called, a subsequent call 


ne 
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to either srand48 or seed48 will restore the “‘standard’’ multiplier and addend 
values, a and c, specified on the previous page. 


SEE ALSO 
rand(3C). 
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NAME 
dup2 - duplicate an open file descriptor 


SYNOPSIS 
int dup2 (fildes, fildes2) 
int fildes, fildes2; 


DESCRIPTION 
The fildes argument is a file descriptor referring to an open file; fildes2 is a 
non-negative integer less than NOFILES. (NOFILES is a system-imposed 
maximum per process [see creat(2)].) The dup2 routine causes fildes2 to refer 
to the same file as fildes. If fildes2 already referred to an open file, it is closed 
first. 


Note that dup2 fails if one or more of the following are true: 


[EBADF] fildes is not a valid open file descriptor. 
{[EMFILE] NOFILES file descriptors are currently open. 
SEE ALSO 


creat(2), close(2), exec(2), fentl(2), open(2), pipe(2), lockf(3C). 


DIAGNOSTICS 
Upon successful completion a non-negative integer, namely the file descriptor, 
is returned. Otherwise, a value of -1 is returned and errno is set to indicate the 
error. 
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NAME 
ecvt, fcvt, gcvt - convert floating-point number to string 


SYNOPSIS 
char *ecvt (value, ndigit, decpt, sign) 
double value; 
int ndigit, *decpt, *sign; 


char *fcvt (value, ndigit, decpt, sign) 
double value; 
int ndigit, *decpt, *sign; 


char *gcvt (value, ndigit, buf) 
double value; 
int ndigit; 
char *buf; 

DESCRIPTION 
The ecvt routine converts value to a null-terminated string of ndigit digits and 
returns a pointer to that string. The high-order digit is non-zero, unless the 
value is zero. The low-order digit is rounded. The position of the decimal point 
relative to the beginning of the string is stored indirectly through decpt 
(negative means to the left of the returned digits). The decimal point is not 
included in the returned string. If the sign of the result is negative, the word 
pointed to by sign is non-zero; otherwise, it is zero. 


The fcvt routine is identical to ecvt, except that the correct digit has been 
rounded for printf ‘*%f'’ (FORTRAN F-format) output of the number of digits 
specified by ndigit. 


The gcvt routine converts the value to a null-terminated string in the array 
pointed to by buf and returns buf. It attempts to produce ndigit significant 
digits in FORTRAN F-format if possible, otherwise in E-format, ready for 
printing. A minus sign if any, or a decimal point, will be included as part of the 
returned string. Trailing zeros are suppressed. 


SEE ALSO 
printf(3S). 


BUGS 
The values returned by ecvt and fcvt point to a single static data array whose 
content is overwritten by each call. 
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NAME 
end, etext, edata - last locations in program 


SYNOPSIS 
extern end; 
extern etext; 
extern edata; 


DESCRIPTION 
These names refer neither to routines nor to locations with interesting contents. 
The address of etext is the first address above the program text, edata above the 
initialized data region, and end above the uninitialized data region. 


When execution begins, the program break (the first location beyond the data) 
coincides with end, but the program break may be reset by the routines of 
brk(2), malloc (3C), standard input/output [stdio(3S)], the profile (-p) option of 
cc(1), and so on. Thus, the current value of the program break should be 
determined by sbrk ((char *)(0)] [see brk(2)}. 


SEE ALSO 
cc(1), brk(2), malloc(3C), stdio(3S). 
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NAME 
erf, erfc - error function and complementary error function 


SYNOPSIS 
#include <math.h> 


double erf (x) 
double x; 


double erfe (x) 
double x; 


DESCRIPTION 
The erf routine returns the error function of x, defined as follows: 


2-2 
Vino 
The erfc routine, which returns 1.0 - erf(x), is provided because of the extreme 
loss of relative accuracy if erf(x) is called for large x and the result subtracted 
from 1.0 (e.g., for x = 5, 12 places are lost). 


SEE ALSO 
exp(3M). 


at. 
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NAME 


exp, log, log10, pow, sqrt - exponential, logarithm, power, square root functions 


SYNOPSIS 


#include <math.h> 


double exp (x) 
double x; 


double log (x) 
double x; 


double log10 (x) 
double x; 

double pow (x, y) 
double x, y; 


double sqrt (x) 
double x; 


DESCRIPTION 


The exp routine returns e*. 

The log routine returns the natural logarithm of x. The value of x must be 
positive. 

The log/0 routine returns the logarithm base ten of x. The value of x must be 
positive. 

The pow routine returns x. If x is zero, y must be positive. If x is negative, y 
must be an integer. 


The sqrt routine returns the non-negative square root of x. The value of x may 
not be negative. 


SEE ALSO 


hypot(3M), matherr(3M), sinh(3M). 


DIAGNOSTICS 


The exp routine returns HUGE when the correct value would overflow, or 0 
when the correct value would underflow, and sets errno to ERANGE. 


The log and /og/10 routines return -HUGE and set errno to EDOM when x is 
non-positive. A message indicating DOMAIN error (or SING error when x is 0) 
is printed on the standard error output. 


The pow routine returns 0 and sets errno to EDOM when x is 0 and y is non- 
positive, or when x is negative and y is not an integer. In these cases a message 
indicating DOMAIN error is printed on the standard error output. When the 
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correct value for pow would overflow or underflow, pow returns +HUGE or 0, 
respectively, and sets errno to ERANGE. 


The sqrt routine returns 0 and sets errno to EDOM when x is negative. A 
message indicating DOMAIN error is printed on the standard error output. 


These error-handling procedures may be changed with the _ function 
matherr (3M). 
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NAME 
fclose, fflush - close or flush a stream 


SYNOPSIS 
#include <stdio.h> 


int fclose (stream) 
FILE *stream; 


int fflush (stream) 
FILE *stream; 


DESCRIPTION 
The fclose routine causes any buffered data for the named stream to be written 
out, and the stream to be closed. 


The fclose routine is performed automatically for all open files upon calling 
exit (2). 

The fflush routine causes any buffered data for the named stream to be written 
to that file. The stream remains open. 


SEE ALSO 
close(2), exit(2), fopen(3S), setbuf(3S), stdio(3S). 


DIAGNOSTICS 
These functions return 0 for success and EOF if any error was detected (such as 
trying to write to a file that has not been opened for writing). 
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NAME 
ferror, feof, clearerr, fileno - stream status inquiries 


SYNOPSIS 
#include <stdio.h> 


int ferror (stream) 
FILE *stream; 


int feof (stream) 
FILE *stream; 


void clearerr (stream) 
FILE *stream; 


int fileno (stream) 
FILE *stream; 


DESCRIPTION 
The ferror routine returns non-zero when an I/O error has previously occurred 
reading from or writing to the named stream, otherwise zero. 


The feof routine returns non-zero when EOF has previously been detected 
reading the named input stream, otherwise zero. 


The clearerr routine resets the error indicator and EOF indicator to zero on the 
named stream. 


The fileno routine returns the integer file descriptor associated with the named 
stream; see open(2). 

SEE ALSO 
open(2), fopen(3S), stdio(3S). 


NOTES 
All the functions are implemented as macros; they cannot be declared or 
redeclared. 
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NAME 
floor, ceil, fmod, fabs - floor, ceiling, remainder, absolute value functions 


SYNOPSIS 
#include <math.h> 


double floor (x) 
double x; 


double ceil (x) 
double x; 


double fmod (x, y) 
double x, y; 


double fabs (x) 
double x; 


DESCRIPTION 
The floor routine returns the largest integer (as a double-precision number) not 
greater than x. 


The ceil routine returns the smallest integer not less than x. 


The fmod routine returns the floating-point remainder of the division of x by y: 
x if y is zero or if x/y would overflow; otherwise the number f with the same 
sign as x, such that x = iy + f for some integer i, and | fl<lyl. 


The fabs routine returns the absolute value of x,|x!. 


SEE ALSO 
abs(3C). 
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NAME 


fopen, freopen, fdopen - open a stream 


SYNOPSIS 


#include <stdio.h> 


FILE *fopen (filename, type) 
char *filename, *type; 


FILE *freopen (filename, type, stream) 
char *filename, *type; 
FILE *stream; 


FILE *fdopen (fildes, type) 
int fildes; 
char *type; 


DESCRIPTION 


The fopen routine opens the file named by filename and associates a stream 
with it. The routine returns a pointer to the FILE structure associated with the 
stream. 


The filename argument points to a character string that contains the name of the 
file to be opened. 


The type argument is a character string having one of the following values: 


r open for reading 

w truncate or create for writing 

a append; open for writing at end of file, or create for writing 
r+ open for update (reading and writing) 

W+ truncate or create for update 

a+ append; open or create for update at end-of-file 


The freopen routine substitutes the named file in place of the open stream. The 
original stream is closed, regardless of whether the open ultimately succeeds. 
The routine returns a pointer to the FILE structure associated with stream. 


The freopen routine is typically used to attach the preopened streams 
associated with stdin, stdout and stderr to other files. 


The fdopen routine associates a stream with a file descriptor. File descriptors 
are obtained from open, dup, creat, or pipe(2), which open files but do not 
return pointers to a FILE structure stream. Streams are necessary input for many 
of the Section 3S library routines. The type of stream must agree with the 
mode of the open file. 
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When a file is opened for update, both input and output can be done on the 
resulting stream. However, output cannot be followed directly by input without 
an intervening fseek or rewind, and input cannot be followed directly by output 
without an intervening fseek, rewind, or an input operation which encounters 
end-of-file. 


When a file is opened for append (that is, when type is a or a+), it is impossible 
to overwrite information already in the file. fseek can be used to reposition the 
file pointer to any position in the file, but when output is written to the file, the 
current file pointer is disregarded. All output is written at the end of the file 
and causes the file pointer to be repositioned at the end of the output. If two 
separate processes open the same file for append, each process may write freely 
to the file without fear of destroying output being written by the other. The 
output from the two processes will be intermixed in the file in the order in 
which it is written. 


SEE ALSO 
creat(2), dup(2), open(2), pipe(2), fclose(3S), fseek(3S), stdio(3S). 


DIAGNOSTICS 
The fopen , fdopen, and freopen routines return a NULL pointer on failure. 
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NAME 


FPGETROUND(3C) 


fpgetround, fpsetround, fpgetmask, fpsetmask, fpgetsticky, fpsetsticky - IEEE 
floating point environment control 


SYNOPSIS 


#include <ieeefp.h> 


typedef enum { 


FP_RN=0, 
FP_RZ=0x10, 
FP_RM=0x20, 
FP_RP=0x30, 
} fp_rnd; 


fp_rnd fpgetround( ); 


/* round to nearest */ 

/* round to zero (truncate) */ 
/* round to minus */ 

/* round to plus */ 


fp_rnd fpsetround(rnd_dir) 
fp_rnd rnd dir; 


#define 
#define 


#define 


#define 


#define 


#define 


fp_except fpgetmask( ); 


fp_except 
FP_X INV 


FP_X_OFL 
FP_X UFL 
FP X DZ 


FP_X IMP 


int 
0x80 


0x40 


0x20 


0x10 


0x08 


fp_except fpsetmask(mask); 
fp_except mask; 


fp_except fpgetsticky( ); 


fp_except fpsetsticky(sticky); 
fp_except sticky; 


DESCRIPTION 


/* invalid operation */ 
/* exception */ 

/* overflow */ 

/+* exception */ 

/* underflow */ 

/* exception */ 

/+ divide-by-zero */ 
/* exception */ 

/* imprecise (loss */ 
/* of precision) */ 


These routines let the user change the behavior on occurrence of any of five 
floating point exceptions: divide-by-zero, overflow, underflow, imprecise 
(inexact) result, and invalid operation. The routines also change the rounding 
mode for floating point operations. When a floating point exception occurs, the 
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corresponding sticky bit is set (1), and if the mask bit is enabled (1), the trap 
takes place. The routines are valid only on systems that are equipped with 
floating point accelerator hardware; otherwise, floating point operations are 
compiled differently and handled in software. 


The fpgetround () routine returns the current rounding mode. 


The fpsetround() routine sets the rounding mode and returns the previous 
rounding mode. 


The fpgetmask () routine returns the current exception masks. 


The fpsetmask() routine sets the exception masks and returns the previous 
setting. 


The fpgetsticky () routine returns the current exception sticky flags. 


The fpsetsticky () routine sets (clears) the exception sticky flags and returns the 
previous setting. 


The environment for Convergent computers that combine the MC68020 CPU 
with the MC68881 or MC68882 floating point processor follows: 

e Rounding mode set to nearest(FP_RN), 

® Divide-by-zero, 


e Floating point overflow, and 


® Invalid operation traps enabled. 
SEE ALSO 
isnan(3C). 
CAVEATS 


The utilities described in this manual page are applicable only for computers 
that are equipped with both the MC68020 microprocessor for the CPU and the 
MC68881 or MC68882 microprocessor for a hardware floating point accelerator. 
Programs that invoke these utilities that are run on computers without the 
floating point hardware result in no operation and no returned error message for 
the particular function. 


One must clear the sticky bit to recover from the trap and to proceed. If the 
sticky bit is not cleared before the next trap occurs, a wrong exception type may 
be signaled. 


For the same reason, when calling fpsetmask() the user should make sure that 
the sticky bit corresponding to the exception being enabled is cleared. 
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WARNINGS 
The fpsetsticky() routine modifies all sticky flags; fpsetmask() changes all 
mask bits. 


C requires truncation (round to zero) for floating point to integral conversions. 
The current rounding mode has no effect on these conversions. 
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NAME 
fread, fwrite - binary input/output 


SYNOPSIS 
#include <stdio.h> 
#include <sys/types.h> 


int fread (ptr, size, nitems, stream) 
char *ptr; 

int nitems; 

size_t Size; 

FILE *stream; 


int fwrite (ptr, size, nitems, stream) 
char *ptr; 

int nitems; 

size_t size; 

FILE *stream; 


DESCRIPTION 

The fread routine copies, into an array pointed to by pir, nitems items of data 
from the named input stream, where an item of data is a sequence of bytes (not 
necessarily terminated by a null byte) of length size. The routine stops 
appending bytes if an end-of-file or error condition is encountered while 
reading stream, or if nitems items have been read. The fread routine leaves the 
file pointer in stream, if defined, pointing to the byte following the last byte 
read if there is one. It does not change the contents of stream. 


The fwrite routine appends at most nitems items of data from the array pointed 
to by pir to the named output stream; it stops appending when it has appended 
nitems items of data or if an error condition is encountered on stream. The 
fwrite routine does not change the contents of the array pointed to by pir. 


The argument size is typically sizeof(*ptr) where the pseudo-function sizeof 
specifies the length of an item pointed to by ptr. If ptr points to a data type 
other than char it should be cast into a pointer to char. 


SEE ALSO 
read(2), write(2), fopen(3S), getc(3S), gets(3S), printf(3S), putc(3S), puts(3S), 
scanf{(3S), stdio(3S). 

DIAGNOSTICS 
The fread and fwrite routines return the number of items read or written. If 


nitems 1S non-positive, no characters are read or written and 0 is returned by 
both fread and fwrite. 
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NAME 
frexp, ldexp, modf - manipulate parts of floating-point numbers 


SYNOPSIS 
double frexp (value, eptr) 
double value; 
int *eptr; 


double Idexp (value, exp) 
double value; 
int exp; 


double modf (value, iptr) 
double value, *iptr; 


DESCRIPTION 
Every non-zero number can be written uniquely as x* 2”, where the 
“‘mantissa’’ (fraction) x is in the range 0.5 <!xI< 1.0, and the ‘‘exponent’’ v is 
an integer. frexp returns the mantissa of a double value, and stores the 
exponent indirectly in the location pointed to by eptr. If value is zero, both 
results returned by frexp are zero. 


The /dexp routine returns the quantity value * 2°? . 
The modf routine returns the signed fractional part of value and stores the 
integral part indirectly in the location pointed to by iptr. 


DIAGNOSTICS 
If ldexp would cause overflow, +HUGE (defined in <math.h> ) is returned 
(according to the sign of value), and errno is set to ERANGE. 
If ldexp would cause underflow, zero is returned and errno is set to ERANGE. 
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NAME 
fseek, rewind, ftell - reposition a file pointer in a stream 


SYNOPSIS 
#include <stdio.h> 


int fseek (stream, offset, ptrname) 
FILE *stream; 

long offset; 

int ptrname; 


void rewind (stream) 
FILE *stream; 


long ftell (stream) 
FILE *stream; 


DESCRIPTION 
The fseek routine sets the position of the next input or output operation on the 
stream. The new position 1s at the signed distance offset bytes from the 
beginning, from the current position, or from the end of the file, according as 
ptrname has the value 0, 1, or 2. 


The rewind(stream) routine is equivalent to fseek (stream, OL, 0), except that no 
value is returned. 


The fseek and rewind routines undo any effects of ungetc (3S). 


After fseek or rewind, the next operation on a file opened for update may be 
either input or output. 


The ftell routine returns the offset of the current byte relative to the beginning 
of the file associated with the named stream. 


SEE ALSO 
Iseek(2), fopen(3S), popen(3S), stdio(3S), ungetc(3S). 


DIAGNOSTICS 
The fseek routine returns non-zero for improper seeks, otherwise zero. An 
improper seek can be, for example, an fseek done on a file that has not been 
opened via fopen; in particular, fseek may not be used on a terminal, or on a file 
opened via popen(3S). 
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WARNING 
Although on the CTIX system and other systems derived from the UNIX system, 
an offset returned by ftell is measured in bytes, and it is permissible to seek to 
positions relative to that offset, portability to non-UNIX systems requires that an 
offset be used by fseek directly. Arithmetic may not meaningfully be performed 
on such an offset, which is not necessarily measured in bytes. 
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NAME 
ftw - walk a file tree 


SYNOPSIS 
#include <ftw.h> 


int ftw (path, fn, depth) 
char *path; 

int (+fn) ( ); 

int depth; 


DESCRIPTION 

The ftw routine recursively descends the directory hierarchy rooted in path. 
For each object in the hierarchy, ftw calls fn, passing it a pointer to a null- 
terminated character string containing the name of the object, a pointer to a stat 
structure [see stat(2)] containing information about the object, and an integer. 
Possible values of the integer, defined in the <ftw.h> header file, are FTW_F for 
a file, FrW_D for a directory, FTW_DNR for a directory that cannot be read, and 
FTW_NS for an object for which stat could not be executed successfully. If the 
integer is FTW_DNR, descendants of that directory will not be processed. If the 
integer is FTW_NS, the stat structure will contain garbage. An example of an 
object that would cause FTW_NS to be passed to fn would be a file in a 
directory with read but without execute (search) permission. 


The ftw routine visits a directory before visiting any of its descendants. 


The tree traversal continues until the tree is exhausted, an invocation of fn 
retums a non-zero value, or some error is detected within ftw (such as an I/O 
error). If the tree is exhausted, ftw returns zero. If fn returns a non-zero value, 
ftw stops its tree traversal and returns whatever value was returned by fn. If ftw 
detects an error, it returns -1, and sets the error type in errno. 


The ftw routine uses one file descriptor for each level in the tree. The depth 
argument limits the number of file descriptors so used. If depth is zero or 
negative, the effect is the same as if it were 1. Depth must not be greater than 
the number of file descriptors currently available for use. The ftw routine runs 
more quickly if depth is at least as large as the number of levels in the tree. 


SEE ALSO 
stat(2), malloc(3C). 


CAVEAT 
The ftw routine uses malloc(3C) to allocate dynamic storage during its 
operation. If ftw is forcibly terminated, such as by longjmp being executed by 
fn or an interrupt routine, ftw will not have a chance to free that storage, so it 
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BUGS 


will remain permanently allocated. A safe way to handle interrupts is to store 
the fact that an interrupt has occurred, and arrange to have fn return a non-zero 
value at its next invocation. 


Because ftw is recursive, it is possible for it to terminate with a memory fault 
when applied to very deep file structures. 
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NAME 
gamma - log gamma function 


SYNOPSIS 
#include <math.h> 


double gamma (x) 
double x; 


extern int signgam; 
DESCRIPTION 


The gamma routine returns in(|T(x)1), where I'(x) is defined as fete dt. 


0 
The sign of I(x) is returned in the external integer signgam. The argument x 
cannot be a non-positive integer. 


The following C program fragment might be used to calculate I: 


if ((y = gamma(x)) > LN_ MAXDOUBLE) 
error(); 
y = signgam * exp{y); 
where LN_MAXDOUBLE is the least value that causes exp(3M) to return a range 
error, and 1s defined in the <values.h> header file. 


SEE ALSO 
exp(3M), matherr(3M), values(5). 


DIAGNOSTICS 
For non-negative integer arguments HUGE is returned, and errno is set to 
EDOM. A message indicating SING error is printed on the standard error 
output. 


If the correct value would overflow, gamma returns HUGE and sets errno to 
ERANGE. 


These error-handling procedures can be changed with the function 
matherr (3M). 
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NAME 
getc, getchar, fgetc, getw - get character or word from a stream 


SYNOPSIS 
#include <stdio.h> 


int getc (stream) 
FILE *stream; 


int getchar () 


int fgetc (stream) 
FILE *stream; 


int getw (stream) 
FILE *stream; 


DESCRIPTION 
The getc routine returns the next character (that is, byte) from the named input 
stream, aS an integer. It also moves the file pointer, if defined, ahead one 
Character in stream. The getchar variable is defined as getc(stdin); getc and 
getchar are macros. 


The fgetc routine behaves like getc, but it is a function rather than a macro; it 
runs more slowly than gefc, but it takes less space per invocation and its name 
can be passed as an argument to a function. 


The getw routine returns the next word (for example, integer) from the named 
input stream. The routine increments the associated file pointer, if defined, to 
point to the next word. The size of a word is the size of an integer and varies 
from machine to machine. It assumes no special alignment in the file. 


SEE ALSO 
fclose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), putc(3S), scanf(3S), 
stdio(3S). 


DIAGNOSTICS 
These functions return the constant EOF at end-of-file or upon an error. 
Because EOF is a valid integer, ferror (3S) should be used to detect getw errors. 


CAVEATS 
Because it is implemented as a macro, getc evaluates a stream argument more 
than once. In particular, getc(#f++) does not work sensibly; fgetc should be 
used instead. 


Because of possible differences in word length and byte ordering, files written 
using putw are machine-dependent and cannot be read using getw ona different 
processor. 
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WARNING 
If the integer value returned by getc, getchar , or fgetc is stored into a character 
variable and then compared against the integer constant EOF, the comparison 
may never succeed because sign extension of a character on widening to integer 
is machine-dependent. 
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NAME 
getcwd - get path-name of current working directory 


SYNOPSIS 
char *getcwd (buf, size) 
char *buf; 
int size; 


DESCRIPTION 
The getcwd routine returns a pointer to the current directory path name. The 
value of size must be at least two greater than the length of the path-name to be 
returned. 


If buf is a NULL pointer, getcwd gets size bytes of space using malloc(3C). In 
this case, the pointer returned by getcwd can be used as the argument in a 
subsequent call to free. 

The function is implemented by using popen(3S) to pipe the output of the 
pwd(1) command into the specified string space. 


EXAMPLE 
void exit(), perror(); 


if ((cwd = getewd((char «)NULL, 64)) == NULL) { 
perror("pwd"); 
exit(2); 
} 
printf("%s\n", cwd); 
SEE ALSO 
pwd(1), malloc(3C), popen(3S). 
DIAGNOSTICS 
The getcwd routine returns NULL with errno set to ERANGE if size is not large 
enough, or if an error occurs in a lower-level function. 
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NAME 
getenv - return value for environment name 


SYNOPSIS 
char *getenv (name) 
char #name; 


DESCRIPTION 
The getenv routine searches the environment list [see environ (5)] for a string of 
the form name=value, and returns a pointer to the value in the current 
environment if such a string is present; otherwise, it returns a NULL pointer. 


SEE ALSO 
exec(2), putenv(3C), environ(S). 
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NAME 
getgrent, getgrgid, getgrnam, setgrent, endgrent, fgetgrent - get group file entry 


SYNOPSIS 
#include <grp.h> 
struct group *getgrent ( ) 
struct group *getergid (gid) 
int gid; 
struct group *getgrnam (name) 
char *name; 
void setgrent ( ) 
void endgrent ( ) 
Struct group *fgetgrent (f) 
FILE #f; 


DESCRIPTION 
The getgrent, getgrgid, and getgrnam routines each return a pointer to an 
object with the following structure containing the broken-out fields of a line in 
the /etc/group file. Each line contains a group structure defined in the <grp.h> 
header file: 


struct group { 
char *gr name;  /* the name of the group «/ 
char *gr passwd; /* the encrypted group password */ 


int gr_gid; /+ the numerical group ID */ 
char **gr mem; _ /* vector of pointers to member +/ 
/* names */ 


}; 

When first called, getgrent returns a pointer to the first group structure in the 
file; thereafter, it returns a pointer to the next group structure in the file; so, 
successive calls can be used to search the entire file. The getgrgid routine 
searches from the beginning of the file until a numerical group ID matching gid 
is found and returns a pointer to the particular structure in which it was found. 
The getgrnam routine searches from the beginning of the file until a group 
name matching name is found and returns a pointer to the particular structure in 
which it was found. If an end-of-file or an error is encountered on reading, 
these functions return a NULL pointer. 


A call to setgrent has the effect of rewinding the group file to allow repeated 
searches. The endgrent routine can be called to close the group file when 
processing is complete. 
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The fgetgrent routine returns a pointer to the next group structure in the stream 
f, which matches the format of /etc/group. 


FILES 
/etc/group 


SEE ALSO 

getlogin(3C), getpwent(3C), group(4). 
DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 


CAVEAT = 
All information is contained in a static area, so it must be copied if it is to be 
saved. 


WARNING 
The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 
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NAME 
gethostbyname, gethostbyaddr, gethostent, sethostent, endhostent - get network 
host entry 


SYNOPSIS 
#include <netdb.h> 


extern int h errno; 


struct hostent *gethostbyname(name) 
char *name; 


struct hostent *gethostbyaddr(addr, len, type) 
char *addr; int len, type; 


Struct hostent *gethostent( ) 


sethostent(stayopen) 
int stayopen; 


endhostent( ) 


DESCRIPTION 

The gethostbyname and gethostbyaddr routines each return a pointer to an 
object with the structure illustrated below. This structure contains either the 
information obtained from the name server, named(1M), or broken-out fields 
from a line in /etc/hosts, (if the local name server is not running). 
gethostbyname takes a pointer to the ascii name of the host or one of its aliases. 
gethostbyaddr takes a pointer to address-family specific data; if type is 
AF_INET the data should be a struct in_addr. 


struct hostent { 


char *h_name; /* official name of host */ 
char **h aliases; /* alias list */ 
int h_addrtype; /* host address type */ 
int h_length; /* length of address */ 
char **h_ addr list; /* list of addresses from name server */ 
}; 
#define h_addr h_addr_list[(0} /* address, for backward */ 


/* compatibility */ 
The members of this structure follow: 
h_name Official name of the host. 
h_aliases A zero terminated array of alternate names for the host. 


h_addrtype The type of address being returned; currently it is always 
AF_INET. 
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h_length The length, in bytes, of the address. 


h_addr_list A zero terminated array of network addresses for the host. Host 
addresses are returned in network byte order. 


h_addr The first address in h_addr_list, this is for backward compatiblity. 


The sethostent routine allows a request for the use of a connected socket using 
TCP for queries. If the stayopen flag is non-zero, this sets the option to send all 
queries to the name server using TCP and to retain the connection after each call 
to gethostbyname or gethostbyaddr . 


The endhostent routine closes the TCP connection. 


FILES 
/etc/hosts 


SEE ALSO 
named(1M), inet(3), resolver(3), hosts(4). 
CTIX Network Programmer’ s Primer. 

DIAGNOSTICS 
Error return or EOF status from gethostbyname and gethostbyaddr is indicated 
by return of a null pointer. The external integer h_errno can then be checked to 
see whether this is a temporary failure or an invalid or unknown host. 


The h_errno member can have the following values: 
HOST_NOT_FOUND  Nosuch host is known. 


TRY_AGAIN This is usually a temporary error, and it means that the 
local server did not receive a response from an 
authoritative server. A retry at some later time may 


succeed. 
NO_RECOVERY This is a non-recoverable error. 
NO_ADDRESS The requested name is valid but does not have an IP 


address; this is not a temporary error. This means 
another type of request to the name server will result in 


an answer. 
WARNINGS 
All information is contained in a static area so it must be copied if it is to be 
saved. 


Only the Internet address format is currently understood. 
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NAME 
getlogin - get login name 

SYNOPSIS 
char *getlogin ( ); 

DESCRIPTION 
The getlogin routine returns a pointer to the login name as found in /etc/utmp. 
It can be used in conjunction with getpwnam to locate the correct password file 
entry when the same user ID is shared by several login names. 


If getlogin is called within a process that is not attached to a terminal, it returns 
a NULL pointer. The correct procedure for determining the login name is to call 
cuserid, or to call getlogin and if it fails to call getpwuid. 


FILES 
/etc/utmp 
SEE ALSO 
cuserid(3S), getgrent(3C), getpwent(3C), utmp(4). 


DIAGNOSTICS 
The getlogin routine returns the NULL pointer if name is not found. 


CAVEAT 
The return values point to static data whose content is overwritten by each call. 
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NAME 
getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent - get network entry 


SYNOPSIS 
#include <netdb.h> 


struct netent *getnetent ( ) 


struct netent *getnethyname (name) 
char *name; 


struct netent *getnetbyaddr (net, type) 
long net; 


setnetent (stayopen) 
int stayopen 
endnetent ( ) 
DESCRIPTION 
The getnetent, getnetbyname , and getnetbyaddr routines each return a pointer 


to an object with the following structure containing the broken-out fields of a 
line in the network database, /etc/networks. 


struct netent { 
char ‘“*n_name; * official name of net */ 
char ‘“*n_allases; /* alias list */ 
int n_addrtype; /* net number type */ 
long n_net; /* net number */ 


hs 


The members of this structure are: 
n_name The official name of the network. 
n_aliases A zero-terminated list of alternate names for the network. 


n_addrtype The type of the network number returned; currently only 
AF_INET. 


n_net The network number. Network numbers are returned in machine 
byte order. 


The getnetent routine reads the next line of the file, opening the file if 
necessary. 


The seinetent routine opens and rewinds the file. If the stayopen flag is non- 
zero, the network database is not closed after each call to getnetent (either 
directly or indirectly through one of the other getnet calls). 
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FILES 


The endnetent routine closes the file. 


The getnetbyname and getnetbyaddr routines sequentially search from the 
beginning of the file until a matching net name or net address is found, or until 
EOF is encountered. Network numbers are supplied in host order. If type 
AF_NET Is supplied to gethostbyaddr, net should be right-justified: that is, net 3 
would be a 3 rather than 0x3000000. 


/etc/networks 


SEE ALSO 


networks(4). 
CTIX Network Programmer's Primer. 


DIAGNOSTICS 


BUGS 


A null pointer (0) is returned on EOF or error. 


All information is contained in a static area, so it must be copied if it is to be 
saved. 


Only Internet network numbers are currently understood. 


GETOPT(3C) GETOPT(3C) 


NAME 
getopt - get option letter from argument vector 


SYNOPSIS 
int getopt (argc, argv, optstring) 
int argc; 
char **argv, *opstring; 


extern char *optarg; 
extern int optind, opterr; 


DESCRIPTION 
The getopt routine returns the next option letter in argv that matches a letter in 
optstring. It supports all the rules of the command syntax standard [see 
intro(1)]. So all new commands will adhere to the command syntax standard, 
they should use getopts (1) or getopt(3C) to parse positional parameters and 
check for options that are legal for that command. 


The optstring argument must contain the option letters the command using 
getopt can recognize; if a letter is followed by a colon, the option is expected to 
have an argument, or group of arguments, which must be separated from it by 
white space. 


The optarg variable is set to point to the start of the option-argument on return 
from getopt. 


The getopt routine places in optind the argv index of the next argument to be 
processed. The optind variable is external and is initialized to 1 before the first 
call to getopt. 


When all options have been processed (that is, up to the first non-option 
argument), getopt returns -1. The special option ‘‘--’’ can be used to delimit 
the end of the options; when it is encountered, -1 will be returned, and ‘‘- -’’ 
will be skipped. 
DIAGNOSTICS 

The getopt routine prints an error message on standard error and returns a 
question mark (?) when it encounters an option letter not included in optstring 
or no option-argument after an option that expects one. This error message can 
be disabled by setting opterr to 0. 
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EXAMPLE 
The following code fragment shows how one might process the arguments for a 
command that can take the mutually exclusive options a and b, and the option 
o, which requires an option-argument: 


main (arge, argv) 

int argc; 

char **argv; 

{ 
int c; 
extern char «optarg; 
extern int optind; 


while ((c = getopt(arge, argv, "abo:”)) != -1) 
switch (c) { 
case ‘a: 
if (bfig) 
errflg++; 
else 
afig++; 
break; 
case ‘b’: | 
If (afig) 
errfig++; 
else 
bproc{ ); 
break; 
case ‘O°: 
oflie = optarg; 
break; 
case °?°: 
errfig++; 
} 
If (errfig) { 
(void)fprintf(stderr, “usage:..."); 
exit (2); 
} 
for ( ; optind < argc; optind++) { 
if (access(argvioptind], 4)) { 
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SEE ALSO 
getopts(1), intro(1). 

WARNINGS 
Although the following command syntax rule [see intro(1)] relaxations are 
permitted under the current implementation, they should not be used because 
they may not be supported in future releases of the system. As in the 
EXAMPLE section above, a and Db are Options, and the option o requires an 
option-argument: 

cmd -aboarg file 


(Rule 5 violation: options with option-arguments must not be grouped with 
other options). 
cmd -ab -oarg file 


(Rule 6 violation: there must be white space after an option that takes an 
option-argument). 


Changing the value of the variable optind, or calling getopt with different 
values of argv, may lead to unexpected results. 


GETPASS(3C) GETPASS(3C) 


NAME 
getpass - read a password 


SYNOPSIS 
char *getpass (prompt) 
char *prompt; 


DESCRIPTION 
The getpass routine reads up to a newline or EOF from the file /dev/tty, after 
prompting on the standard error output with the null-terminated string prompt 
and disabling echoing. A pointer is returned to a null-terminated string of at 
most 8 characters. If /dev/tty cannot be opened, a NULL pointer is returned. 
An interrupt will terminate input and send an interrupt signal to the calling 
program before returning. 


FILES 
/dev/tty 
SEE ALSO 
crypt(3C). 
WARNING 


The above routine uses <stdio.h>, which causes it to increase the size of 
programs not otherwise using standard I/O, more than might be expected. 


CAVEAT 
The return value points to static data whose content 1s overwritten by each call. 
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NAME 
getprotoent, getprotobynumber, getprotobyname, setprotoent, endprotoent - get 
protocol entry 


SYNOPSIS 
#include <netdb.h> 


struct protoent *getprotoent ( ) 


struct protoent *getprotobyname (name) 
char *name; 


Struct protoent *getprotobynumber (proto) 
int proto; 
setprotoent (stayopen) 
int stayopen 
endprotoent ( ) 
DESCRIPTION 
The getprotoent , getprotobyname , and getprotobynumber routines each return a 


pointer to an object with the following structure containing the broken-out 
fields of a line in the network protocol database, /etc/protocols. 


struct protoent{ 


char ‘*p name; /* official name of protocol */ 
char ‘*‘p aliases; * alias list */ 
long p_proto; /* protocol number */ 


} 


The members of this structure follow: 

p_name _ The official name of the protocol. 

p_aliases A zero-terminated list of alternate names for the protocol. 
p_proto The protocol number. 


The getprotoent routine reads the next line of the file, opening the file if 
necessary. 

The setprotoent routine opens and rewinds the file. If the stayopen flag is non- 
zero, the network database will not be closed after each call to getprotoent 
(either directly or indirectly through one of the other getproto calls). 
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The endprotoent routine closes the file. 


The getprotobyname and getprotobynumber routines sequentially search from 
the beginning of the file until a matching protocol name or protocol number is 
found, or until EOF is encountered. 


FILES 
/etc/protocols 


SEE ALSO 
protocols(4). 
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DIAGNOSTICS 
Null pointer (0) returned on EOF or error. 


BUGS 
All information is contained in a static area, so it must be copied if it is to be 
saved. 


Only the Internet protocols are currently understood. 
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NAME 
getpw - get name from UID 


SYNOPSIS 
int getpw (uid, buf) 
int uid; 
char *buf; 

DESCRIPTION 
The getpw routine searches the password file for a user ID number that equals 
uid, copies the line of the password file in which uid was found into the array 
pointed to by buf, and returns 0. The routine returns non-zero if uid cannot be 
found. 


This routine is included only for compatibility with prior systems and should 
not be used; see getpwent (3C) for routines to use instead. 


FILES 
/etc/passwd 


SEE ALSO 

getpwent(3C), passwd(4). 
DIAGNOSTICS 

The getpw returns non-zero on error. 


WARNING 
If a program not otherwise using standard I/O uses this routine, the size of the 
program increases more than might be expected. 
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NAME 


GETPWENT(3C) 


getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent - get password 


file entry 


SYNOPSIS 
#include <pwd.h> 


struct passwd *getpwent ( ) 


struct passwd *getpwuid (uid) 


int uid; 


struct passwd *getpwnam (name) 


char *name; 
void setpwent ( ) 


void endpwent ( ) 


struct passwd *fgetpwent (f) 


FILE #f; 
DESCRIPTION 


The getpwent, getpwuid and getpwnam routines each return a pointer to an 
object with the following structure containing the broken-out fields of a line in 
the /etc/passwd file. Each line in the file contains a ‘‘passwd’’ structure, 
declared in the <pwd.h> header file: 


struct passwd { 


char 
char 
int 

int 

char 
char 
char 
char 
char 


} 


«pw_name; 
*pw_passwd; 
pw_uid; 
pw_gid; 
*pw_age; 
*pw_comment; 
*pw_gecos; 
*pw_ dir; 

«pw shell; 


This structure is declared in <pwd.h> so you need not redeclare it. The field 
meanings are described in passwd(4). 


When first called, getpwent returns a pointer to the first passwd structure in the 
file; thereafter, it returns a pointer to the next passwd structure in the file so 
Successive calls can be used to search the entire file. The getpwuid routine 
searches from the beginning of the file until a numerical user ID matching uid is 
found; the routine then returns a pointer to the structure in which it was found. 


soe 
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The getpwnam routine searches from the beginning of the file until a login 
name matching name is found; the routine then returns a pointer to the 
particular structure in which it was found. If an end-of-file or an error is 
encountered on reading, these functions return a NULL pointer. 


A call to setpwent rewinds the password file to allow repeated searches. A call 
to endpwent closes the password file when processing is complete. 


The fgetpwent routine returns a pointer to the next passwd structure in the 
stream f that matches the format of /etc/passwd. 


FILES 
/etc/passwd 


SEE ALSO 

getgrent(3C), getlogin(3C), getspent(3X), putpwent(3C), passwd(4). 
DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 


WARNING 
If a program not otherwise using standard I/O uses this routine, the size of the 
program increases more than might be expected. 


CAVEAT ( 
All information is contained in a static area, so it must be copied if it is to be : 
saved. 
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NAME 

getrpcent, getrpcbyname, getrpcbynumber - get rpc entry 
SYNOPSIS 

#include <netdb.h> 

struct rpcent *getrpcent() 


Struct rpcent *getrpchyname(name) 
char *name; 
struct rpcent *getrpcbynumber(number) 
int number; 
setrpcent(stayopen) 
int stayopen 
endrpcent() 
DESCRIPTION 
The getrpcent, getrpcbyname, and getrpcbynumber routines each return a 


pointer to an object with the following structure containing the broken-out 
fields of a line in the rpc program number database, /etc/rpc. 


struct rpcent { 
char *r_name; /* name of server for this rpc program */ 
char *‘r_aliases; * alias list */ 
long r_number; /* rpc program number */ 


}; 
The members of this structure follow: 
r_name The name of the server for this rpc program. 
r_aliases A zero terminated list of alternate names for the rpc program. 
r_number The rpc program number for this service. 


The getrpcent routine reads the next line of the file, opening the file if 
necessary. 
The setrpcent routine opens and rewinds the file. If the stayopen flag is non- 


zero, the net database will not be closed after each call to getrpcent (either 
directly or indirectly through one of the other ggetrpc calls). 


The endrpcent routine closes the file. 


The getrpcbyname and getrpcbynumber routines sequentially search from the 
beginning of the file until a matching rpc program name or program number is 
found, or until EOF is encountered. 
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FILES 
/etc/rpe 
SEE ALSO 
rpc(4), rpcinfo(1M). 
DIAGNOSTICS 
Null pointer (0) returned on EOF or error. 


BUGS 
Ali information is contained in a static area so it must be copied if it is to be 
saved. 
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NAME 
getrpcport - get RPC port number 


SYNOPSIS 
int getrpcport(host, prognum, versnum, proto) 
char *host; 
int prognum, versnum, proto; 


DESCRIPTION 
The getrpcport routine returns the port number for version versnum of the RPC 
program prognum running on host and using protocol proto. The routine 
returns 0 if it cannot contact the portmapper, or if prognum is not registered; if 
prognum is registered but not with version versnum, getrpcport returns that port 
number. 


SEE ALSO 


portmap(1M), rpcinfo(1M), rpc(4). 
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NAME 
gets, fgets - get a string from a stream 


SYNOPSIS 
#include <stdio.h> 


char *gets (s) 
char *s; 


char *fgets (s, n, stream) 
char *s; 
int n; 
FILE *stream; 

DESCRIPTION 
The gets routine reads characters from the standard input stream, stdin, into the 
atray pointed to by s, until a newline character is read or an end-of-file 
condition is encountered. The newline character is discarded and the string is 
terminated with a null character. 


The fgets routine reads characters from the stream into the array pointed to by 
s, until m-1 characters are read, or a newline character is read and transferred to 
s, or an end-of-file condition is encountered. The string is then terminated with 
a null character. 


SEE ALSO 
ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S), stdio(3S). 


DIAGNOSTICS 
If end-of-file is encountered and no characters have been read, no characters are 
transferred to s and a NULL pointer is returned. If a read error occurs, such as 
trying to use these functions on a file that has not been opened for reading, a 
NULL pointer is returned. Otherwise, s is returned. 
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NAME 
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getservent, getservbyport, getservbyname, setservent, endservent - get service 


entry 
SYNOPSIS 


#include <netdb.h> 


Struct servent *getservent ( ) 


Struct servent *getservbyname (name, proto) 
char *name, *proto; 


struct servent *getservbyport (port, proto) 
int port; char *proto; 


setservent (stayopen) 


int stayopen 
endservent ( ) 
DESCRIPTION 


The getservent, getservbyname, and getservbyport routines each return a 
pointer to an object with the following structure containing the broken-out 
fields of a line in the network services database, /etc/services. 


struct 
char 
char 
long 
char 


} 


servent { 

*s name; /* official name of service */ 
**s aliases; /* allas list */ 

s port; /* port service resides at */ 
*s proto; /* protocol to use */ 


The members of this structure follow: 


Ss name The official name of the service. 


s_aliases A zero-terminated list of alternate names for the service. 


S_port The port number at which the service resides. Port numbers are 
returned in network byte order. 


Ss proto The name of the protocol to use when contacting the service. 


The getservent routine reads the next line of the file, opening the file if 


necessary. 


The setservent routine opens and rewinds the file. If the stayopen flag is non- 
zero, the network database is not be closed after each call to getservent (either 
directly or indirectly through one of the other getserv calls). 
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The endservent routine closes the file. 


The getservbyname and getservbyport routines sequentially search from the 
beginning of the file until a matching protocol name or port number is found, or 
until EOF is encountered. 


If a protocol name is also supplied (non-NULL), searches must also match the 
protocol. 


FILES 
/etc/services 


SEE ALSO 
getprotoent(3), services(4). 
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DIAGNOSTICS 
Null pointer (0) returned on EOF or error. 


BUGS 
All information is contained in a static area, so it must be copied if it is to be 


saved. 
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NAME 
getspent, getspnam, setspent, endspent, fgetspent, Ickpwdf, ulckpwdf - get 
shadow password file entry 


SYNOPSIS 
#include <shadow.h> 


struct spwd *getspent () 


struct spwd *getspnam (name) 
char *name; 


int Ickpwdf () 
int ulckpwedf () 


void setspent () 
void endspent () 


struct spwd *fgetspent (fp) 
FILE *fp; 


DESCRIPTION 
The getspent and getspnam routines each return a pointer to an object with the 
following structure containing the broken-out fields of a line in the /etc/shadow 
file. Each line in the file contains a shadow password structure (spwd), 
declared in the < shadow.h > header file: 


struct spwd{ 
char *sp namp; 
char *sp_ pwdp; 
long sp_istchg; 
long sp_min; 
long sp max; 
}; 
The getspent routine, when first called, returns a pointer to the first spwd 
structure in the file; thereafter, it returns a pointer to the next spwd structure in 
the file; this way, successive calls can be used to search the entire file. The 
getspnam routine searches from the beginning of the file untl a login name 
matching name is found, and then returns a pointer to the particular structure in 
which it was found. The getspent and getspnam routines populate the sp_min 
or sp_max field with -1 if the corresponding field in /etc/shadow is empty. If 
an end-of-file or an error is encountered on reading, these functions return a 
NULL pointer. 


The /etc/.pwd.lock file is the lock file, which is used to coordinate modification 
access to the password files in /etc/passwd and /etc/shadow. The Ickpwdf() 
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FILES 


and ulckpwdf() routines are used to gain modification access to the password 
files, through the lock file. A process first uses Ickpwdf() to lock the lock file, 
thereby gaining exclusive rights to modify the /etc/passwd or /etc/shadow file. 
Upon completing modifications, a process should release the lock on the lock 
file by using ulckpwdf(). This lock mechanism prevents simultaneous 
modification of the password files. 

The ickpwdf() routine attempts to lock the file /etc/.pwd.iock. If the file is 
already locked, Ickpwdf() tries for 15 seconds to lock the file. If unsuccessful, 
Ickpwdf() returns a -1; if successful within 15 seconds, Ickpwdf() returns a 
return code other than -1. 


The ulckpwdf() routine attempts to unlock the file /etc/.pwd.lock. If 
successful, ulckpwdf() returns a 0; if unsuccessful (if the file is not locked), 
ulckpwaf() returns a -1. 


A call to the setspent routine has the effect of rewinding the shadow password 
file to allow repeated searches. The endspent routine may be called to close the 
shadow password file when processing is complete. 


The fgetspent routine returns a pointer to the next spwd structure in the stream 
fp, which matches the format of /etc/shadow. 


/etc/shadow 
etc/passwd 
/etc/.pwd.lock 


SEE ALSO 


putspent(3X), shadow(4). 


DIAGNOSTICS 


A NULL pointer is returned on EOF or error. 


CAVEAT 


All information is contained in a static area, so it must be copied if it 1s to be 
saved. 


WARNING 


If a program not otherwise using standard I/O uses this routine, the size of the 
program increases more than might be expected. 


This routine is for internal use only; compatibility is not guaranteed. 
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NAME 


GETUT(3C) 


getut: getutent, getutid, getutline, pututline, setutent, endutent, utmpname - 
access utmp file entry 


SYNOPSIS 


#include <utmp.h> 


struct utmp *getutent ( ) 


struct utmp *getutid (id) 
struct utmp *id; 


struct utmp *getutline (line) 


Struct utmp *line; 


void pututline (utmp) 
struct utmp *utmp; 


void setutent ( ) 


void endutent ( ) 


void utmpname (file) 


char *file; 


DESCRIPTION 
The getutent, getutid and getutline routines each return a pointer to a structure 
of the following type: 
struct utmp { 
char ut_user[8]; /+ User login name «/ 
char ut_id[4]; /* /etc/inittab id (usually line #) +/ 
char ut_line[12]; /« Device name (console, Inxx) */ 
short ut_pid; /* Process id +/ 
short ut type; /* Type of entry */ 
struct exit_status { 
short e termination; /+ Process termination status +/ 
short e exit; /x Process exit status */ 
} ut_exit; /+ The exit status of a process marked */ 
/* as DEAD PROCESS. +/ 
time t ut_time; /* Time entry was made «/ 
} 


The getutent routine reads in the next entry from a utmp-like file. If the file is 
not already open, it opens it. If it reaches the end of the file, it fails. 


The getutid routine searches forward from the current point in the ump file 
until it finds an entry with a ut type matching id->ut_type if the type specified 
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FILES 


is RUN_LVL, BOOT_TIME, OLD_TIME or NEW_TIME. If the type specified in 
id is INIT_PROCESS, LOGIN_PROCESS, USER_PROCESS or DEAD_PROCESS, 
getutid returns a pointer to the first entry whose type is one of these four and 
whose ut id field matches id->ut id. If the end of file 1s reached without a 
match, it fails. 


The getutline routine searches forward from the current point in the utmp file 
until it finds an entry of the type LOGIN_PROCESS or USER_PROCESS which 
also has a ut line string matching the line->ut_line string. If the end of file is 
reached without a match, it fails. 


The pututline routine writes out the supplied ump structure into the utmp file. 
It uses getutid to search forward for the proper place if it finds that it is not 
already at the proper place. It is expected that normally the user of pututline 
will have searched for the proper entry using one of the getut routines. If so, 
pututline will not search. If pututline does not find a matching slot for the new 
entry, it will add a new entry to the end of the file. 


The setutent routine resets the input stream to the beginning of the file. This 
should be done before each search for a new entry if it is desired that the entire 
file be examined. 


The endutent routine closes the currently open file. 


The utmpname routine allows the user to change the name of the file examined, 
from /etc/utmp to any other file. It is most often expected that this other file 
will be /etc/wtmp. If the file does not exist, this will not be apparent until the 
first attempt to refer to the file is made. The utmpname routine does not open 
the file. It just closes the old file if it is currently open and saves the new file 
name. 


/etc/utmp 
/etc/wtmp 


SEE ALSO 


ttyslot(3C), utmp(4). 


DIAGNOSTICS 


NOTES 


A NULL pointer is returned upon failure to read, whether for permissions or 
having reached the end of file, or upon failure to write. 


The most current entry is saved in a static structure. Multiple accesses require 
that it be copied before further accesses are made. Each call to either getutid or 
getutline sees the routine examine the static structure before performing more 
l/O. If the contents of the static structure match what it is searching for, it looks 
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no further. For this reason, to use getutline to search for multiple occurrences, 
it would be necessary to zero out the static after each success, or getutline 
would just return the same pointer over and over again. There is one exception 
to the rule about removing the structure before further reads are done. The 
implicit read done by pututline (if it finds that it is not already at the correct 
place in the file) will not hurt the contents of the static structure returned by the 
getutent, getutid or getutline routines, if the user has just modified those 
contents and passed the pointer back to pututline . 


These routines use buffered standard I/O for input, but pututline uses an 
unbuffered non-standard write to avoid race conditions between processes 
trying to modify the utmp and wtmp files. 
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NAME 


hsearch, hcreate, hdestroy - manage hash search tables 


SYNOPSIS 


#include <search.h> 


ENTRY *hsearch (item, action) 
ENTRY item; 
ACTION action; 


int hcreate (nel) 
unsigned nel; 


void hdestroy ( ) 


DESCRIPTION 


NOTES 


The hsearch routine is a hash-table search routine generalized from Knuth (6.4) 
Algorithm D. It returns a pointer into a hash table indicating the location at 
which an entry can be found. /tem is a structure of type ENTRY (defined in the 
<search.h> header file) containing two pointers: iftem.key points to the 
comparison key, and item.data points to any other data to be associated with 
that key. (Pointers to types other than character should be cast to pointer-to- 
character.) Action is a member of an enumeration type ACTION indicating the 
disposition of the entry if it cannot be found in the table. ENTER indicates that 
the item should be inserted in the table at an appropriate point. FIND indicates 
that no entry should be made. Unsuccessful resolution is indicated by the return 
of a NULL pointer. 


The hcreate routine allocates sufficient space for the table, and must be called 
before hsearch is used. Nel is an estimate of the maximum number of entries 
that the table will contain. This number may be adjusted upward by the 
algorithm in order to obtain certain mathematically favorable circumstances. 


The hdestroy routine destroys the search table and can be followed by another 
call to Acreate . 


The Asearch routine uses open addressing with a multiplicative hash function. 
However, its source code has many other options available which the user can 
select by compiling the hsearch source with the following symbols defined to 
the preprocessor: 


DIV Use the remainder modulo table size as the hash function instead of 
the multiplicative algorithm. 
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USCR Use a User Supplied Comparison Routine for ascertaining table 
membership. The routine should be named hcompar and should 
behave in a manner similar to strcmp [see string (3C)]. 


CHAINED Use a linked list to resolve collisions. If this option is selected, the 
following other options become available. 


START Place new entries at the beginning of the linked list 
(default is at the end). 


SORTUP Keep the linked list sorted by key in ascending order. 


SORTDOWN Keep the linked list sorted by key in descending 
order. 


Additionally, there are preprocessor flags for obtaining debugging printout 
(-DDEBUG) and for including a test driver in the calling routine (-DDRIVER). 
The source code should be consulted for further details. 


EXAMPLE 
The following example will read in strings followed by two numbers and store 
them in a hash table, discarding duplicates. It will then read in strings and find 
the matching entry in the hash table and print it. 


#include <stdio.h> 
#include <search.h> 


struct info { /* this is the info stored in the */ 
int age, room; /* table other than the key. */ 
} 
#define NUM_EMPL 5000 /* # of elements in search table */ 
main( ) 
{ 
/« space to store strings */ 
char string space[NUM_EMPL+20]; 
/* space to store employee info */ 
struct info info_space[NUM_EMPL]; 
/* next avail spacein string space +/ 
char +str_ptr= string space; 
/* next avail space in info_space «/ 
struct info +info_ptr = info_space; 
ENTRY Item, *«found_ltem, *hsearch( ); 
/* name to look for in table */ 
char name_to_find[30]; 
inti = 0; 
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/* create table */ 
(void) hcreate(NUM_EMPL); 
while (scanf("%s%d%d", str_ptr, &info_ptr->age, 
&info_ptr->room) != EOF && i++ < NUM_EMPL) { 
/* put info in structure, and structure in *+/ 
/* item */ 
item.key = str_ptr; 
item.data = (char *)info_ptr; 
str_ptr += strien(str_ ptr) + 1; 
info_ptr++; 
/+ put item into table +/ 
(void) hsearch(item, ENTER); 
} 


/* access table +/ 
item.key = name_to_find; 
while (scanf("%s", item.key) != EOF) { 
if ((found_item = hsearch(item, FIND)) != NULL) { 
/* If item is in the table +/ 
(void)printf(“found %s, age = %d, room = %d\n", 
found_item->key, 
((struct info *)found_item->data)->age, 
((struct info *)found_item->data)>room); 
} else { 
(void)printf("no such employee %s\n", 
name_to find) 


} 


SEE ALSO 
bsearch(3C), Isearch(3C), malloc(3C), malloc(3X), string(3C), tsearch(3C). 


DIAGNOSTICS 
The hsearch routine returns a NULL pointer if either the action is FIND and the 
item could not be found or the action is ENTER and the table is full. 


The Acreate routine returns zero if it cannot allocate sufficient space for the 
table. 


CAVEAT 
Only one hash search table can be active at any given time. 


WARNING 
The hsearch and hcreate routines use malloc (3C) to allocate space. 
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NAME 
hypot - Euclidean distance function 


SYNOPSIS 
#include <math.h> 


double hypot (x, y) 
double x, y; 
DESCRIPTION 
The hypot routine returns the following, taking precautions against unwarranted 
overflows: 


sqrt(x * x + y * y), 


SEE ALSO 
matherr(3M). 


DIAGNOSTICS 
When the correct value would overflow, hypot returns HUGE and sets errno to 
ERANGE. 


These error-handling procedures may be changed with the function 
matherr (3M). 
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NAME 


inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_Inaof, inet_netof - 
Internet address manipulation routines 


SYNOPSIS 


#include <sys/socket.h> 
#include <netinet/in.h> 
#include <arpa/inet.h> 


unsigned long inet_addr(cp) 
char *cp; 

int inet_network(cp) 

char *cp; 

char *inet_ntoa(in) 

struct inet_addr in; 

struct in_addr inet_makeaddr(net, Ina) 
int net, Ina; 

int inet_Inaof(in) 

struct in_addr in; 

int inet_netof(in) 

struct in_addr in; 


DESCRIPTION 


The routines inet_addr and inet network each interpret character strings 
representing numbers expressed in the Internet standard dot notation, returning 
numbers suitable for use as Internet addresses and Internet network numbers, 
respectively. The struct in_addr returned by inet_addr is cast to an unsigned 
long for error checking (See Diagnostics, below.) The routine inet ntoa takes 
an Internet address and returns an ASCII string representing the address in dot 
notation. The routine inet_makeaddr takes an Internet network number and a 
local network address and constructs an Internet address from it. The routines 
inet _netof and inet Inaof break apart Internet host addresses, returning the 
network number and local network address part, respectively. 


All Internet addresses are returned in network order (bytes ordered from left to 
right). All network numbers and local address parts are returned as machine 
format integer values. 
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INTERNET ADDRESSES 
Values specified using the dot notation take one of the following forms: 
a.b.c.d 
a.b.c 
a.b 
a 
When four parts are specified, each is interpreted as a byte of data and assigned, 


from left to right, to the four bytes of an Internet address. 


When a three part address is specified, the last part is interpreted as a 16-bit 
quantity and placed in the right most two bytes of the network address. This 
makes the three part address format convenient for specifying Class B network 
addresses as 128.net .host. 


When a two part address is supplied, the last part is interpreted as a 24-bit 
quantity and placed in the right most three bytes of the network address. This 
makes the two part address format convenient for specifying Class A network 
addresses as net .host. 


When only one part is given, the value is stored directly in the network address 
without any byte rearrangement. 


All numbers supplied as ‘‘parts’’ in a ‘‘dot’’ notation may be decimal, octal, or 
hexadecimal, as specified in the C language (that 1s, a leading Ox or OX implies 
hexadecimal; otherwise, a leading 0 implies octal; otherwise, the number is 
interpreted as decimal). 


EXAMPLE 

#include <stdio.h> 

#include <sys/types.h> 

#include <sys/socket.h> 

#include <netdb.h> 

#include <sys/in.h> 

#include <arpa/inet.h> 

int check_address(address_s) 

char address _s[]; /* ascii string (e.g., first token 
* in /etc/hosts entry) 
*/ 


{ 
struct in_addr addr; 
int re; 
re=0; 
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/* check that address is in valid format and get binary 
* form to pass to gethostbyaddr 
*/ 
addr.s_addr= inet_addr (address _s); 
if (addr.s_ addr == -1) 
{ 
fprintf (etderr, 
“Address ‘%s’ not in valid Internet format\n", 
address _s); 
re =-1; 
return (rc); 


} 


/* check that address Is not already In host database */ 
if ((int) gethostbyaddr (&addr, 
sizeof (addr), AF_INET) != NULL) 


{ 
fprintf (stderr, 
“Address ‘%s’ already in use\n”, 
address s); 
re =-1; 
} 


return (rc); 


} * check_address*/ 


SEE ALSO 
gethostbyname(3), getnetent(3), hosts(4), networks(4), inet(7). 
CTIX Network Programmer's Primer. 


DIAGNOSTICS 
The value -1 is returned by inet_addr and inet_network for malformed requests. 


BUGS 
The string returned by inet_ntoa resides in a static memory area. 
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NAME 
isnan: isnand, isnanf - test for floating point NaN (Not-A-Number) 


SYNOPSIS 
#include <ieeefp.h> 


int isnand (dsrc) 
double dsrc; 


int isnanf (fsrc) 
float fsre; 


DESCRIPTION 
The isnand and isnanf routines return true (1) if the argument dsrc or fsrc is a 
NaN; otherwise, they return false (0). 


Neither routine generates any exception, even for signaling NaNs. 
The isnanf() routine is implemented as a macro included in <ieeefp.h>. 


SEE ALSO 
fpgetround(3C). 
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NAME 
[3tol, Itol3 - convert between 3-byte integers and long integers 


SYNOPSIS 
void [3tol (Ip, cp, n) 
long *lp; 
char *cp; 
int n; 
void Itol3 (cp, Ip, n) 
char *cp; 
long *Ip; 
int n; 
DESCRIPTION 
The [3tol routine converts a list of nm three-byte integers packed into a character 


string pointed to by cp into a list of long integers pointed to by Ip. 
The /[tol3 routine performs the reverse conversion from long integers (Ip) to 
three-byte integers (cp). 
These functions are useful for file-system maintenance where the block 
numbers are three bytes long. 

SEE ALSO 
fs(4). 


CAVEAT 
Because of possible differences in byte ordering, the numerical values of the 
long integers are machine-dependent. 
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NAME 
Idahread - read the archive header of a member of an archive file 


SYNOPSIS 
#include <stdio.h> 
#include <ar.h> 
#include <filehdr.h> 
#inciude <idfcn.h> 
int Idahread (Idptr, arhead) 
LDFILE *ldptr; 
ARCHDR *arhead; 
DESCRIPTION 
If TYPE(/dptr) is the archive file magic number, [dahread reads the archive 
header of the common object file currently associated with idpir inio the area of 
memory beginning at arhead. 


The Idahread routine returns SUCCESS or FAILURE; it fails if TYPE(/dptr) 
does not represent an archive file, or if it cannot read the archive header. 


The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
Idclose(3X), Idopen(3X), ar(4), Idfcn(4). 
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NAME 
Idclose, Idaclose - close a common object file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idclose (idptr) 
LDFILE *ldptr; 


int Idaclose (Idptr) 
LDFILE *ldptr; 


DESCRIPTION 
The Idopen(3X) and Idclose routines provide uniform access to both simple 
object fiies and object files that are members of archive files. Thus, an archive 
of common object files can be processed as if it were a series of simple common 
object files. 


If TYPE(/dpir) does not represent an archive file, ldclose closes the file and free 
the memory allocated to the LDFILE structure associated with /dptr. If 
TYPE(/dptr) is the magic number of an archive file, and if there are any more 
files in the archive, Idclose reinitializes OFFSET (/dptr ) to the file address of the 
next archive member and returns FAILURE. The LDFILE structure is prepared 
for a subsequent Idopen(3X). In all other cases, /dclose returns SUCCESS. 


The Idaclose routine closes the file and frees the memory allocated to the 
LDFILE structure associated with [dptr regardless of the value of TYPE(/dptr). 
The /[daclose routine always returns SUCCESS. The function is often used in 
conjunction with /daopen. 


The program must be loaded with the object file access routine library libld.a. 


SEE ALSO 
fclose(3S), Idopen(3X), Idfcn(4). 
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NAME 


Idfhread - read the file header of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Ildfhread (ldptr, filehead) 
LDFILE *ldptr; 
FILHDR *filehead; 


DESCRIPTION 


FILES 


The Idfhread routine reads the file header of the common object file currently 
associated with [dptr into the area of memory beginning at filehead. 


The idfhread routine returns SUCCESS or FAILURE. I[dfhread fails if it cannot 
read the file header. 


In most cases the use of Idfhread can be avoided by using the macro 
HEADER(/dptr) defined in Idfcen.h [see Idfcn (4)]. The information in any 
field, fieldname, of the file header may be _ accessed using 
HEADER (ldptr).fieldname. 


The program must be loaded with the object file access routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), Idopen(3X), idfcn(4). 
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NAME 
Idgetname - retrieve symbol name for common object file symbol table entry 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <idfcn.h> 


char *ldgetname (Iidptr, symbol) 
LDFILE *ldptr; 
SYMENT *symbol; 


DESCRIPTION 
The [dgetname routine returns a pointer to the name associated with symbol as 
a string. The siring is contained in a static buffer jocai to idgetname that is 
overwritten by each call to ldgetname, and therefore must be copied by the 
caller if the name is to be saved. 


The I[dgetname routine can be used to retrieve names from object files without 
any backward compatibility problems. The /dgetname routine returns NULL 
(defined in stdio.h) for an object file if the name cannot be retrieved, as in the 
following cases: 


e If the string table cannot be found. 
e If not enough memory can be allocated for the string table. 


e If the string table appears not to be a string table (for example, if an 
auxiliary entry is handed to /dgetname that looks like a reference to a 
name in a nonexistent string table). 


® If the name’s offset into the string table is past the end of the string 
table. 


Typically, [dgetname is called immediately after a successful call to Idtbread to 
retrieve the name associated with the symbol table entry filled by [dtbread. 


The program must be loaded with the object file access routine library libid.a. 


SEE ALSO 
ldclose(3X), ldopen(3X), ldtbread(3X), Idtbseek(3X), Idfcn(4). 
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NAME 
Idlread, Idlinit, Idlitem - manipulate line number entries of a common object file 
function 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#inciude <iinenum.h> 
#include <Idfcn.h> 
int Idlread(Idptr, fcnindx, linenum, linent) 
LDFILE *ldptr; 
long fcnindx; 
unsigned short linenum; 
LINENO #*linent; 


int Idlinit(ddptr, fcnindx) 
LDFILE *ldptr; 
long fenindx; 


int Idlitem(Idptr, linenum, linent) 
LDFILE *ldptr; 

unsigned short linenum; 

LINENO *linent; 


DESCRIPTION 

The /diread routine searches the line number entries of the common object file 
currently associated with [dptr. It begins its search with the line number entry 
for the beginning of a function and confines its search to the line numbers 
associated with a single function. The function is identified by fcnindx, the 
index of its entry in the object file symbol table. The routine reads the entry 
with the smallest line number equal to or greater than linenum into the memory 
beginning at linent. 


The /dlinit and Idlitem routines together perform exactly the same function as 
ldlread. After an initial call to /dlread or Idlinit, ldlitem can be used to retrieve 
a series of line number entries associated with a single function. The /dlinit 
routine locates the line number entries for the function identified by fcnindx; 
Idlitem finds and reads the entry with the smallest line number equal to or 
greater than linenum into the memory beginning at linent. 


The ldlread, Idlinit, and Idlitem routines each return either SUCCESS or 
FAILURE. The /dlread routine fails if there are no line number entries in the 
object file, if fenindx does not index a function entry in the symbol table, or if it 
finds no line number equal to or greater than linenum. The ldlinit routine fails 
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if there are no line number entries in the object file or if fcnindx does not index 
a function entry in the symbol table. The /dlitem routine fails if it finds no line 


number equal to or greater than linenum. 
The programs must be loaded with the object file access routine library libid.a. 


FILES 
fusrflib/libld.a 
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SEE ALSO 
Idclose(3X), Idopen(3X), Idtbindex(3X), Idfcn(4). 
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NAME 
Idlseek, Idnlseek - seek to line number entries of a section of a common object 
file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <ldfcii.i> 
int Idlseek (Idptr, sectindx) 
LDFILE *Idptr; 
unsigned short sectindx; 
int Idnlseek (Idptr, sectname) 
LDFILE *idptr; 
char *sectname; 
DESCRIPTION 


The /dlseek routine seeks to the line number entries of the section specified by 
sectindx of the common object file currently associated with Idptr. 


The /dniseek routine seeks to the line number entries of the section specified by 
seciname . 


The Idlseek and Idniseek routines return SUCCESS or FAILURE. The /dlseek 
routine fails if sectindx is greater than the number of sections in the object file; 
Idniseek fails if there is no section name corresponding with *sectname. Either 
function fails if the specified section has no line number entries or if it cannot 
seek to the specified line number entries. 


Note that the first section has an index of one. 
The program must be loaded with the object file access routine library libld.a. 


FILES 
/usr/lib/libld.a 


SEE ALSO 
Idclose(3X), Idopen(3X), Idshread(3X), Idfcn(4). 
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NAME 
Idohseek - seek to the optional file header of a common object file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idohseek (Idptr) 
LDFILE *ldptr; 


DESCRIPTION 
The ldohseek routine seeks to the optional file header of the common object file 
currently associated with /dpir. It returns SUCCESS or FAILURE. The routine 
fails if the object file has no optional header or if it cannot seek to the optional 
header, 
The program must be loaded with the object file access routine library libld.a. 


FILES 
/usr/lib/libld.a 


SEE ALSO 
ldclose(3X), Idopen(3X), ldfhread(3X), Idfcn(4). 
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NAME 
Idopen, Idaopen - open a common object file for reading 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


LDFILE *Idopen (filename, Idptr) 
char *filename; 
LDFILE *ldptr; 


LDFILE *idaopen (filename, oldptr) 
char *filename; 
LDFILE *oldptr; 


DESCRIPTION 
The /dopen and Idclose(3X) routines provide uniform access to both simple 
object files and object files that are members of archive files. Thus, an archive 
of common object files can be processed as if it were a series of simple common 
object files. | 


If [dptr has the value NULL, /dopen opens filename and allocates and initializes 
the LDFILE structure, and returns a pointer to the structure to the calling 
program. 

If Idpir is valid and if TYPE(/dptr) is the archive magic number, /dopen 
reinitializes the LDFILE structure for the next archive member of filename . 


The ldopen and Idclose routines are designed to work in concert. The Idclose 
routine returns FAILURE only when TYPE(/dptr) is the archive magic number 
and there is another file in the archive to be processed. Only then should 
Idopen be called with the current value of /dptr. In all other cases, in particular 
whenever a new filename is opened, [dopen should be called with a NULL I[dptr 
argument. 


The following is a prototype for the use of idopen and Idclose. 


/* for each filename to be processed +/ 

Idptr = NULL; 

do 

{ 
if ( (Idptr = Idopen(filename, Idpir)) [= NULL ) 
{ 


{* check magic number; process the file */ 


} 
} while (Idclose(idptr) == FAILURE ); 


eds 
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FILES 


If the value of oldptr is not NULL, Idaopen opens filename anew and allocate 
and initialize a new LDFILE structure, copying the TYPE, OFFSET, and 
HEADER fields from oldptr. The Idaopen routine returns a pointer to the new 
LDFILE structure. This new pointer is independent of the old pointer, oldptr. 
The two pointers can be used concurrently to read separate parts of the object 
file. For example, one pointer can be used to step sequentially through the 
relocation information, while the other is used to read indexed symbol table 
entries. 

Both Idopen and Idaopen open filename for reading. Both functions return 
NULL if filename cannot be opened, or if memory for the LDFILE structure 
cannot be allocated. A successful open does not insure that the given file is a 
common object file or an archived object file. 


The program must be loaded with the object file access routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


fopen(3S), Idclose(3X), Idfcn(4). 
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NAME 


ldrseek, Idnrseek - seek to relocation entries of a section of a common object 
file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <ldfcn.h> 
int Idrseek (Idptr, sectindx) 


LDFILE *ldptr; 
unsigned short sectindx; 


int Idnrseek (Idptr, sectname) 
LDFILE *ldptr; 
char *sectname; 


DESCRIPTION 
The Idrseek routine seeks to the relocation entries of the section specified by 
sectindx of the common object file currently associated with /dptr. 


The ldnrseek routine seeks to the relocation entries of the section specified by 
sectname. 


The ldrseek and Idnrseek routines return SUCCESS or FAILURE. The [drseek 
fails if sectindx is greater than the number of sections in the object file; Idnrseek 
fails if there is no section name corresponding with sectname. Either function 
fails if the specified section has no relocation entries or if it cannot seek to the 
specified relocation entries. 


Note that the first section has an index of one. 
The program must be loaded with the object file access routine library libld.a. 


FILES 
fusr/lib/libld.a 


SEE ALSO 
Idclose(3X), Idopen(3X), Idshread(3X), Idfcn(4). 
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NAME 


Idshread, Idnshread - read an indexed/named section header of a common object 
file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <senhdr.h> 
#include <Idfcn.h> 


int Idshread (Idptr, sectindx, secthead) 
LDFILE *ldptr; 

unsigned short sectindx; 

SCNHDR *secthead; 


int Idnshread (Idptr, sectname, secthead) 
LDFILE *ldptr; 

char *sectname; 

SCNHDR *secthead; 


DESCRIPTION 


FILES 


The /idshread routine reads the section header specified by sectindx of the 
common object file currently associated with /dpir into the area of memory 
beginning at secthead. 


The [dnshread routine reads the section header specified by sectname into the 
area of memory beginning at secthead. 


The [dshread and Idnshread routines return SUCCESS or FAILURE. The 
ldshread routine fails if sectindx is greater than the number of sections in the 
object file; Idnshread fails if there is no section name corresponding with 
sectname. Either function fails if it cannot read the specified section header. 


Note that the first section header has an index of one. 
The program must be loaded with the object file access routine library libld.a. 


fusr/lib/libid.a 


SEE ALSO 


Idclose(3X), ldopen(3X), Idfcn(4). 
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NAME 


Idsseek, Idnsseek - seek to an indexed/named section of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int idsseek (Idptr, sectindx) 
LDFILE *lIdptr; 
unsigned short sectindx; 


int Idnsseek (Idptr, sectname) 
LDFILE *ldptr; 
char *sectname; 


DESCRIPTION 


FILES 


The /dsseek routine seeks to the section specified by sectindx of the common 
object file currently associated with Idptr. 


The Idnsseek routine seeks to the section specified by sectname. 


The Idsseek and Idnsseek routines return SUCCESS or FAILURE. The Idsseek 
fails if sectindx is greater than the number of sections in the object file; Idnsseek 
fails if there is no section name corresponding with sectname. Either function 
fails if there is no section data for the specified section or if it cannot seek to the 
specified section. 


Note that the first section has an index of one. 
The program must be loaded with the object file access routine library libld.a. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), Idopen(3X), Idshread(3X), Idfcn(4). 
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NAME 
|dtbindex - compute the index of a symbol table entry of a common object file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <)dfcn.h> 


long Idtbindex (idptr) 
LDFILE *ldptr; 


DESCRIPTION 


Idtbindex returns the (long) index of the symbol table entry at the current 
position of the common object file associated with Idpir . 


The index returned by /dtbindex can be used in subsequent calls to 
ldtbread(3X). However, since Idtbindex returns the index of the symbol table 
entry that begins at the current position of the object file, if Idtbindex is called 
immediately after a particular symbol table entry has been read, it will return 
the index of the next entry. 


ldtbindex will fail if there are no symbols in the object file, or if the object file 
is not positioned at the beginning of a symbol table entry. 


Note that the first symbol in the symbol table has an index of zero. 
The program must be loaded with the object file access routine library libld.a. 


FILES 
/usr/lib/libld.a 


SEE ALSO 
idclose(3X), Idopen(3X), Idtbread(3X), Idtbseek(3X), Idfcn(4). 
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NAME 


Idtbread - read an indexed symbol table entry of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <Idfcn.i> 


int Idtbread (Idptr, symindex, symbol) 
LDFILE *ldptr; 

long symindex; 

SYMENT *symbol; 


DESCRIPTION 


FILES 


ldtbread reads the symbol table entry specified by symindex of the common 
object file currently associated with /dptr into the area of memory beginning at 
symbol . 


ldtbread returns SUCCESS or FAILURE. I[dtbread will fail if symindex is 
greater than or equal to the number of symbols in the object file, or if it cannot 
read the specified symbol table entry. 


Note that the first symbol in the symbol table has an index of zero. 
The program must be loaded with the object file access routine library libld.a:. 


/usr/lib/libld.a 


SEE ALSO 


Idclose(3X), ldopen(3X), ldtbseek(3X), ldgetname(3X), Idfcn(4). 
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NAME 
Idtbseek - seek to the symbol table of a common object file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idtbseek (Idptr) 
LDFILE *ldptr; 


DESCRIPTION 
Idtbseek seeks to the symbol table of the common object file currently 
associated with /dptr. 


ldtbseek returns SUCCESS or FAILURE. I/dtbseek will fail if the symbol table 
has been stripped from the object file, or if it cannot seek to the symbol table. 


The program must be loaded with the object file access routine library libld.a. 


FILES 
/usrflib/libld.a 


SEE ALSO 
Idclose(3X), Idopen(3X), Idtbread(3X), Idfcn(4). 
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NAME 


LIBDEV(3X) 


libdev - manipulate Volume Home Blocks (VHB) 


SYNOPSIS 


#include <sys/gdisk.h> 


struct vhbd *vhbd; 


short el Ko 


aU Oly ao 
char *s, *device; 
int fd; 


int gdnsec(vhbd, sl) 
int gdstrk(vhbd, sl) 
int gdftrk(vhbd, sl) 


int gdnszc(vhbd) 
int isdisk(fd) 


struct vhbd *readvhb(s, sl) 
Struct vhbd *sreadvhb(device) 
struct vhbd *freadvhb(fd, sl) 
char *adevname(fd) 

char *bdevname(s) 


int dismnt(fd) 


char *gdname(s, slp) 
char *fgdname(fd, sip) 


int gdniblk(fd) 
DESCRIPTION 


Each argument in the above subroutines denotes: 


vhbd 


sl 


sip 


device 


A pointer to a disk volume home block, as returned by 
readvhb , sreadvhb, or freadvhb. 


Slice number on the drive. 


Pointer to a slice number. This argument is actually used by 
the subroutine to return a slice number. 


The name of a special file in /dev/rdsk. This filename is 
used to obtain a file descriptor to access a VHB. The name 
need not be for slice zero of the disk. 


The name of a special file in /dev/rdsk. This filename is 
used to obtain a file descriptor to access a VHB. The name 
must be for slice zero of a disk. 
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fd 
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Open file descriptor for slice zero of a disk. 


The subroutines in /usr/lib/libdev.a form a device and machine independent 
interface to the VHB of CTIX disks. The function of each subroutine is 


described below: 


gdnsec 
gdstrk 
gdfirk 


gdnszc 
isdisk 


Returns the number of sectors in slice si of the VHB indicated 
by vhbd. 


Returns the starting track of slice s/ of the VHB pointed to by 
vhbd. 


Returns 1 if slice s? of the VHB pointed to by vhbd extends to 
the end of the disk. 


Returns the number of sectors per cylinder. 


Returns 1 if the file descriptor fd is opened to a speciai disk 
device. 


readvhb, sreadvhb, and freadvhb 


adevname 


bdevname 


dismnt 


gdname 


fgdname 


gdnlblk 


Return a pointer to a VHB for the device described by their 
arguments. 


Returns the character device name for the disk drive to 
which the file descriptor fd is opened. 


Returns the block device name for the disk drive that the 
string s names. The filename S§ can be for any slice on a raw 
or block device. 


Exercises the GDDISMNT ioctl call for the disk drive that the 
file descriptor to which fd is opened. 


Returns the file name for the character special slice zero of a 
disk the filename s name a slice of. The value pointed to by 
slp is set to the slice number of the filename s. 


Performs as does gdname, but uses the file descriptor fd 
instead of the filename s. 


Returns the number of logical blocks in the slice to which the 
file descriptor fd is opened. 
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FILES 
/dev/rdsk/c?d?s? 
/dev/dsk/c?d?s? 
/usr/lib/libdev.a 


SEE ALSO 
iv(1) disk(7). 


LIBDEV (3X) 


LOCKF (3C) LOCKF(3C) 


NAME 
lockf - record locking on files 


SYNOPSIS 
#include <unistd.h> 


int lockf (fildes, function, size) 


int fildes, function; 


DESCRIPTION 
The lockf command will allow sections of a file to be locked; advisory or 
mandatory write locks depending on the mode bits of the file [see chmod(2)]. 
Locking calls from other processes that to lock the locked file section will 
either return an error value or be put to sleep until the resource becomes 
unlocked. All the iocks for a process are removed when the process terminates. 
[See fcntl(2) for more information about record locking.] 


fildes is an open file descriptor. The file descriptor must have O_WRONLY or 
O_RDWR permission in order to establish lock with this function call. 


function is a control value that specifies the action to be taken. The permissible 
values for function are defined in <unistd.h> as follows: 


#define F_ULOCKO /+* Unlock a previously locked section +/ 
#define F_LOCK 1  /+ Lock a section for exclusive use +/ 
#define F_TLOCK 2 /+* Test and lock a section for +/ 

/* exclusive use +/ 
#define F_TEST 3  /* Test section for other processes */ 

/* locks */ 


All other values of function are reserved for future extensions and will result in 
an error return if not implemented. 


F_TEST is used to detect if a lock by another process is present on the specified 
section. F_LOCK and F_TLOCK both lock a section of a file if the section is 
available. F_ULOCK removes locks from a section of the file. 


Size is the number of contiguous bytes to be locked or unlocked. The resource 
to be locked starts at the current offset in the file and extends forward for a 
positive size and backward for a negative size (the preceding bytes up to but not 
including the current offset). If size is zero, the section from the current offset 
through the largest file offset is locked (that is, from the current offset through 
the present or any future end-of-file). An area need not be allocated to the file 
in order to be locked because such locks can exist past the end-of-file. 
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The sections locked with F_LOCK or F_TLOCK may, in whole or in part, contain 
or be contained by a previously locked section for the same process. When this 
occurs, or if adjacent sections occur, the sections are combined into a single 
section. If the request requires that a new element be added to the table of 
active locks and this table is already full, an error is returned, and the new 
section is not locked. 


F_LOCK and F_TLOCK requests differ only by the action taken if the resource is 
not available. F_LOCK will cause the calling process to sleep until the resource 
is available. F_TLOCK will cause the function to return a -1 and set errno to 
[EACCES}] error if the section is already locked by another process. 


F_ULOCK requests may, in whole or in part, release one or more locked sections 
controlled by the process. When sections are not fully released, the remaining 
sections are still locked by the process. Releasing the center section of a locked 
section requires an additional element in the table of active locks. If this table 
is full, an [EDEADLK] error is returned and the requested section is not released. 


A potential for deadlock occurs if a process controlling a locked resource is put 
to sleep by accessing another process’s locked resource. Thus calls to lock or 
fcnil scan for a deadlock prior to sleeping on a locked resource. An error return 
is made if sleeping on the locked resource would cause a deadlock. 


Sleeping on a resource is interrupted with any signal. The alarm(2) command 
can be used to provide a timeout facility in applications that require this 


facility. 

The lockf utility will fail if one or more of the following are true: 

[EBADF] fildes is not a valid open descriptor. 

[EACCES] cmd is F_TLOCK or F_TEST and the section is already locked 
by another process. 

[EDEADLK] cmd 1s F_LLOCK and a deadlock would occur. 

[ENOLCK] The cmd is F_LLOCK, FT_LOCK, or F_ULOCK and the number 


of entries in the lock table would exceed the number 
allocated on the sytem. (Note that this differs from 
EDEADLOCK). 


[ECOMM] fildes is on a remote machine and the link to that machine is 
no longer active. 
SEE ALSO 
chmod(2), close(2), creat(2), fentl(2), intro(2), open(2), read(2), write(2). 
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DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


WARNINGS 
Unexpected results may occur in processes that do buffering in the user address 
space. The process may later read/write data that is/was locked. The standard 
I/O package is the most common source of unexpected buffering. 


Because in the future the variable errno will be set to EAGAIN rather than 
EACCES when a section of a file is already locked by another process, portable 
application programs should expect and test for either value. 
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NAME 
logname - return login name of user 


SYNOPSIS 
char *logname( ) 


DESCRIPTION 
logname returns a pointer to the null-terminated login name; it extracts the 
LOGNAME environment variable from the user’s environment. 


This routine is kept in /lib/libPW.a. 


FILES 
/etc/profile 
/usr/lib/libPW.a 


SEE ALSO 
env(1), login(1), getenv(3C), profile(4), environ(5). 


CAVEATS 
The return values point to static data whose content is overwritten by each call. 


This method of determining a login name is subject to forgery. 
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NAME 


Isearch, Ifind - linear search and update 


SYNOPSIS 


#include <stdio.h> 
#include <search.h> 


char *lsearch ((char *)key, (char *)base, neln, sizeof(+key), compar) 
unsigned *nelp; 
int (*compar)( ); 


char *lfind ((char *)key, (char *)base, nelp, sizeof(+key), compar) 
unsigned *nelp; 
int (*compar)( ); 


DESCRIPTION 


NOTES 


lsearch is a linear search routine generalized from Knuth (6.1) Algorithm S. It 
returns a pointer into a table indicating where a datum may be found. If the 
datum does not occur, it is added at the end of the table. key points to the 
datum to be sought in the table. base points to the first element in the table. 
nelp points to an integer containing the current number of elements in the table. 
The integer is incremented if the datum is added to the table. compar is the 
name of the comparison function which the user must supply (strcmp, for 
example). It is called with two arguments that point to the elements being 
compared. The function must return zero if the elements are equal and non- 
zero otherwise. 


lfind is the same as [search except that if the datum is not found, it is not added 
to the table. Instead, a NULL pointer is returned. 


The pointers to the key and the element at the base of the table should be of 
type pointer-to-element, and cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may be 
contained in the elements in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be 
Cast into type pointer-to-element. 


EXAMPLE 


This fragment will read in less than TABSIZE strings of length less than ELSIZE 
and store them in a table, eliminating duplicates. 


#include <stdio.h> 
#include <search.h> 


#define TABSIZE 50 
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#define ELSIZE 120 


char line[ELSIZE], tab[TABSIZE][ELSIZE], +isearch( ); 
unsigned nel = 0; 
int stremp{ ); 


while (fgets(line, ELSIZE, stdin) != NULL && 
nel < TABSIZE) 
(void) isearch(line, (char *)tab, &nel, 
ELSIZE, strcmp); 


SEE ALSO 
bsearch(3C), hsearch(3C), string(3C), tsearch(3C). 


DIAGNOSTICS 
If the searched for datum is found, both /search and [find return a pointer to it. 
Otherwise, [find returns NULL and /search returns a pointer to the newly added 
element. 


BUGS 
Undefined results can occur if there is not enough room in the table to add a 


new item. = 
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NAME 
malloc, free, realloc, calloc - main memory allocator 


SYNOPSIS 
char *malloc (size) 
unsigned size; 


void free (ptr) 
char *ptr; 


char *realloc (ptr, size) 
char *ptr; 
unsigned size; 


char *calloc (nelem, elsize) 
unsigned nelem, elsize; 


DESCRIPTION 
malloc and free provide a simple general-purpose memory allocation package. 
malloc returns a pointer to a block of at least size bytes suitably aligned for any 
use. 


The argument to free is a pointer to a block previously allocated by malloc; 
after free is performed this space is made available for further allocation, but its 
contents are left undisturbed. 


Undefined results will occur if the space assigned by malloc is overrun or if 
some random number is handed to free. 


malloc allocates the first big enough contiguous reach of free space found in a 
circular search from the last block allocated or freed, coalescing adjacent free 
blocks as it searches. It calls sbrk [see brk(2)] to get more memory from the 
system when there is no suitable space already free. 


realloc changes the size of the block pointed to by ptr to size bytes and returns 
a pointer to the (possibly moved) block. The contents will be unchanged up to 
the lesser of the new and old sizes. If no free block of size bytes is available in 
the storage arena, then realloc will ask malloc to enlarge the arena by size 
bytes and will then move the data to the new space. 


realloc also works if ptr points to a block freed since the last call of malloc, 
realloc, or calloc; thus sequences of free, malloc and realloc can exploit the 
search strategy of malloc to do storage compaction. 


calloc allocates space for an array of nelem elements of size elsize. The space 
is initialized to zeros. 
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Each allocation routine returns a pointer to space suitably aligned (after 
possible pointer coercion) for storage of any type of object. 


SEE ALSO 
brk(2), malloc(3X). 


DIAGNOSTICS 


malloc, realloc and calloc return a NULL pointer if there is no available 
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memory or if the arena has been detectably corrupted by storing outside the 
bounds of a block. When this happens the block pointed to by ptr may be 
destroyed. 


NOTES 
Search time increases when many objects have been allocated; that is, if a 
program allocates but never frees, then each successive allocation takes longer. 
For an alternate, more flexible implementation, see malloc (3X). 
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NAME 
malloc, free, realloc, calloc, mallopt, mallinfo - fast main memory allocator 


SYNOPSIS 
#include <malloc.h> 


char *malloc (size) 
unsigned size; 


void free (ptr) 
char *ptr; 


char *realloc (ptr, size) 
char *ptr; 
unsigned size; 


char *calloc (nelem, elsize) 
unsigned nelem, elsize; 


int mallopt (cmd, value) 
int cmd, value; 


struct mallinfo mallinfoQ 


DESCRIPTION 
malloc and free provide a simple general-purpose memory allocation package, 
which runs considerably faster than the malloc(3C) package. It is found in the 
library “‘malloc’’, and is loaded if the option ‘‘-Imalloc’’ is used with cc(1) or 
ld(1). 


malloc returns a pointer to a block of at least size bytes suitably aligned for any 
use. 


The argument to free is a pointer to a block previously allocated by malloc; 
after free is performed this space is made available for further allocation, and 
its contents have been destroyed (but see mallopt below for a way to change 
this behavior). 


Undefined results will occur if the space assigned by malloc is overrun or if 
some random number is handed to free. 


realloc changes the size of the block pointed to by pir to size bytes and returns 
a pointer to the (possibly moved) block. The contents will be unchanged up to 
the lesser of the new and old sizes. 


calloc allocates space for an array of nelem elements of size elsize. The space 
is initialized to zeros. 

mallopt provides for control over the allocation algorithm. The available 
values for cmd are: 
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M_MXFAST 


M_NLBLKS 


M_GRAIN 


M_KEEP 
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Set maxfast to value. The algorithm allocates all blocks 
below the size of maxfast in large groups and then doles 
them out very quickly. The default value for maxfast is 24. 


Set numlblks to value. The above mentioned ‘‘large groups’’ 
each contain numlblks blocks. Numlbiks must be greater than 
0. The default value for numlblks is 100. 


Set grain to value. The sizes of all blocks smaller than 
maxfast are considered to be rounded up to the nearest 
multiple of grain. Grain must be greater than 0. The default 
value of grain is the smallest number of bytes which will 
allow alignment of any data type. Value will be rounded up 
to a multiple of the default when grain is set. 

Preserve data in a freed block until the next malloc, realloc, 
or calloc. This option is provided only for compatibility 
with the old version of malloc and is not recommended. 


These values are defined in the <malloc.h> header file. 


mallopt can be called repeatedly, but cannot be called after the first small block 


is allocated. 
mallinfo provides instrumentation describing space usage. It returns the 
Structure: 
struct mallinfo { 
int arena; /* total space in arena */ 
int ordbiks; /« number of ordinary blocks +/ 
int smbiks; /x number of smali blocks +/ 
int hbikhd; /* space in holding block headers */ 
int hbiks; /* number of holding blocks */ 
intusmbiks; /* spacein small blocks in use +/ 
int fsmbiks; /+ space in free small blocks +/ 
int uordbiks; /* spacein ordinary blocks in use */ 
int fordbiks; /* space in free ordinary blocks */ 
Int keepcost; /* space penalty if keep option is used *+/ 
} 


This structure is defined in the <malloc.h> header file. 


Each of the allocation routines returns a pointer to space suitably aligned (after 
possible pointer coercion) for storage of any type of object. 


SEE ALSO 


brk(2), malloc(3C). 


MALLOC (3X) MALLOC (3X) 


DIAGNOSTICS 
malloc, realloc and calloc return a NULL pointer if there is not enough 
available memory. When realloc returns NULL, the block pointed to by pir is 
left intact. If mallopt is called after any allocation or if cmd or value are 
invalid, non-zero is returned. Otherwise, it returns zero. 

WARNINGS 
This package usually uses more data space than maiioc (3C). 
The code size is also bigger than malloc (3C). 


Note that unlike malloc (3C), this package does not preserve the contents of a 
block when it is freed, unless the M_KEEP option of mallopt is used. 


Undocumented features of malloc (3C) have not been duplicated. 
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NAME 
matherr - error-handling function 


SYNOPSIS 
#include <math.h> 


int matherr (x) 
struct exception *x; 


DESCRIPTION 
matherr is invoked by functions in the Math Library when errors are detected. 
Users can define their own procedures for handling errors by including a 
function named matherr in their programs. matherr must be of the form 
described above. When an error occurs, a pointer to the exception structure x 
will be passed to the user-supplied matherr function. This structure, which is 
defined in the <math.h> header filc, is as follows: 


struct exception { 


int type; 
char *name; 
double arg1, arg2, retval; 


}; 
The element type is an integer describing the type of error that has occurred, 
from the following list of constants (defined in the header file): 
DOMAIN Argument domain error. 
SING Argument singularity. 
OVERFLOW Overflow range error. 
UNDERFLOW _ Underflow range error. 
TLOSS Total loss of significance. 
PLOSS Partial loss of significance. 


The element name points to a string containing the name of the function that 
incurred the error. The variables arg/ and arg2 are the arguments with which 
the function was invoked. retval is set to the default value that will be returned 
by the function unless the user’s matherr sets it to a different value. 


If the user’s matherr function returns non-zero, no error message will be 
printed, and errno will not be set. 


If matherr is not supplied by the user, the default error-handling procedures, 
described with the math functions involved, will be invoked upon error. These 
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procedures are also summarized in the table below. In every case, errno is set 
to EDOM or ERANGE and the program continues. 


EX AMPLE 
#include <math.h> 


int 
matherr(x) 
register struct exception +x; 
{ 
switch (x->type) { 
case DOMAIN: 
/* change sqrt to return sqrt(-arg1), not 0 */ 
If (!stromp(x->name, “sqrt")) { 
x->retval = sqrt(-x->arg1); 
return (0); /* print message and set errno */ 
} 
case SING: 
/* all other domain or sing errors, print message and abort +/ 
fprintf(stderr, “domain error in %s\n", x->name); 
abort( ); 
case PLOSS: 
/* print detailed error message */ 
fprintf(stderr, “loss of significance in %s(%g) = 
%g\n", X->name, x->argt, x->retval); 
return (1); /* take no other action */ 
} 
return (0); /* all other errors, execute default procedure */ 
} 
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DEFAULT ERROR HANDLING PROCEDURES 


Types of Errors 


ABBREVIATIONS 
As much as possible of the value is returned. 
Message is printed (EDOM error). 
HUGE is returned. 
-HUGE is returned. 
HUGE or -HUGE is returned. 
0 is returned. 
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NAME 


memory: memccpy, memchr, memcmp, memcpy, memset - memory operations 


SYNOPSIS 


#include <memory.h> 


char *memccpy (s1, s2, ¢c, n) 
char *s1, #82; 
int c, n; 


char *memchr (s, c, n) 
char *s; 
int c, n; 


int mememp (sl, s2, n) 
char *sl, *s2; 

int n; 

char *memcpy (sI, s2, n) 
char *sl, *s2; 

int n; 

char +memset (s, c, n) 
char *s; 

int c, n; 


DESCRIPTION 


These functions operate as efficiently as possible on memory areas (arrays of 
Characters bounded by a count, not terminated by a null character). They do not 
check for the overflow of any receiving memory area. 


memccpy copies characters from memory area s2 into s1, stopping after the first 
occurrence of character c has been copied, or after n characters have been 
copied, whichever comes first. It returns a pointer to the character after the 
copy of c in s1, or a NULL pointer if ¢ was not found in the first n characters of 
S2, 


memchr returns a pointer to the first occurrence of character c¢ in the first n 
characters of memory area s, or a NULL pointer if ¢ does not occur. 


memcmp compares its arguments, looking at the first n characters only, and 
returns an integer less than, equal to, or greater than 0, according as sl is 
lexicographically less than, equal to, or greater than s2. 


memcpy copies n characters from memory area s2 to sl. It returns s1. 


memset sets the first n characters in memory area s to the value of character c. 
It returns s. 
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For user convenience, all these functions are declared in the optional 
<memory.h> header file. 


CAVEATS 
memcmp is implemented by using the most natural character comparison on the 
machine. Thus, the sign of the value returned when one of the characters has its 
high order bit set is not the same in all implementations and should not be relied 
upon. 
Character movement is performed differently in different implementations. 
Thus, overlapping moves may yield surprises. 
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NAME 
mktemp - make a unique file name 


SYNOPSIS 
char *mktemp (template) 
char *template; 


DESCRIPTION 
The mktemp utility replaces the contents of the string pointed to by template by 
a unique file name and returns the address of template . The string in template 
should look like a file name with six trailing Xs; mktemp replaces the Xs with a 
letter and the current process ID. The letter is chosen so that the resulting name 
does not duplicate an existing file. 


SEE ALSO 
getpid(2), tmpfile(3S}, tmpnam(3S), 
DIAGNOSTIC 


The mktemp utility assigns to template the NULL string if it cannot create a 
unique name. 


CAVEAT 
If called more than 26 times in a single process, mktemp starts recycling 
previously used names. 
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NAME 


monitor - prepare execution profile 


SYNOPSIS 


#include <mon.h> 


void monitor (lowpc, highpc, buffer, bufsize, nfunc) 
int (+lowpc)( ), (*highpc)( ); 

WORD *buffer; 

int bufsize, nfunc; 


DESCRIPTION 


An executable program created by cc -p automatically includes calls for 
monitor with default parameters; monitor need not be called explicitly except 
to gain fine control over profiling. 


monitor 1s an interface to profil(2). lowpc and highpc are the addresses of two 
functions; buffer is the address of a (user supplied) array of bufsize WORDs 
(defined in the <mon.h> header file). monitor arranges to record a histogram 
of periodically sampled values of the program counter, and of counts of calls of 
certain functions, in the buffer. The lowest address sampled is that of lowpc 
and the highest is just below highpc. lowpc may not equal 0 for this use of 
monitor. At most nfunc call counts can be kept; only calls of functions 
compiled with the profiling option -p of cc(1) are recorded. 


For the results to be significant, especially where there are small, heavily used 
routines, it is suggested that the buffer be no more than a few times smaller than 
the range of locations sampled. 


To profile the entire program, it is sufficient to use: 


extern etext; 


sanltor ((int (+)())2, &etext, buf, bufsize, nfunc); 
etext lies just above all the program text; see end(3C). 
To stop execution monitoring and write the results, use 
monitor ((int (+*){))0, 0, 0, 0, 0); 
prof(1) can then be used to examine the results. 


The name of the file written by monitor is controlled by the environment 
variable PROFDIR. If PROFDIR does not exist, mon.out is created in the current 
directory. If PROFDIR exists but has no value, monitor does not do any 
profiling and creates no output file. Otherwise, the value of PROFDIR is used as 
the name of the directory in which to create the output file. If PROFDIR is 


i 
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dirname, then the file written is dirname/pid.mon.out, where pid is the 
program’s process ID. (When monitor is called automatically by compiling via 
cc -p, the file created is dirname/pid.progname, where progname is the name of 
the program.) 

FILES 
mon.out 

SEE ALSO 
cc(1), prof(1), profil(2), end(3C). 


BUGS 
The ‘dirname /pid.mon.out’’ form does not work; the 
“‘dirname /pid.progname’’ form (automatically called via cc -p) does work. 
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NAME 
dbm_open, dbm_close, dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, 
dbm_nextkey, dbm_error, dbm_clearerr - database subroutines 


SYNOPSIS 
#include <ndbm.h> 


typedef struct { 
char *dptr; 
int dsize; 
} datum; 
DBM *dbm_open(file, flags, mode) 
char *file; 
int flags, mode; 


void dbm_close(db) 
DBM *db; 


datum dbm_fetch(db, key) 
DBM *db; 
datum key; 


int dbm_store(db, key, content, flags) 
DBM *db; 
datum key, content; 
int flags; 

int dbm_delete(db, key) 
DBM *db; 
datum key; 

datum dbm_firstkey(db) 
DBM *db; 

datum dbm_nextkey(db) 
DBM *db; | 

int dbm_error(db) 
DBM *db; 

int dbm_clearerr(db) 
DBM *db; 

DESCRIPTION 


These functions maintain key/content pairs in a database. The functions will 
handle very large (a billion blocks) databases and will access a keyed item in 
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one or two file system accesses. This package replaces, and is incompatible 
with, the earlier dbm(3x) library, which managed only a single database. 


keys and contents are described by the datum typedef. A datum specifies a 
string of dsize bytes pointed to by dptr. Arbitrary binary data, as well as normal 
ASCII strings, are allowed. The database is stored in two files. One file is a 
directory containing a bit map and has .dir as its suffix. The second file 
contains all data and has .pag as its suffix. 

Before a database can be accessed, it must be opened by dbm_open. This opens 
and/or creates the files file.dir and file.pag depending on the flags parameter 
[see open(2)]. 


Once open, the data stored under a key is accessed by dbm_fetch and data is 
placed under a key by dbm_store. The flags field can be either DBM_INSERT 
or DBM_REPLACE. DBM_INSERT inserts only new entries into the database 
and does not change an existing entry with the same key. DBM REPLACE 
replaces an existing entry if it has the same key. A key (and its associated 
contents) is deleted by dbm_ delete. A linear pass through all keys in a database 
can be made, in an (apparently) random order, by use of dbm_firstkey and 
dbm_nextkey. dbm_firstkey returns the first key in the database. dbm_nextkey 
returns the next key in the database. This code traverses the database: 


for key = dbm_firstkey(db); key.dptr != NULL; key = dbm_nextkey(db) 


dbm_error returns non-zero when an error has occurred reading or writing the 
database. dbm_clearerr resets the error condition on the named database. 


SEE ALSO 
dbm(3X). 


DIAGNOSTICS 
All functions that return an int indicate errors with negative values. A zero 
return indicates no error condition. Routines that return a datum indicate errors 
with a null (0) dptr. If, when dbm_store is called with a flags value of 
DBM_INSERT, it finds an existing entry with the same key, it returns 1. 


WARNINGS 
The .pag file will contain holes so that its apparent size is about four times its 
actual content. Such a file cannot be copied by normal means (cp, cat, tp, tar, 
ar) without filling in the holes. 


dptr pointers returned by these subroutines point into static storage that is 
changed by subsequent calls. 


The sum of the sizes of a key/content pair must not exceed the internal block 
size (currently 4096 bytes). Moreover all key/content pairs that hash together 


-2- 


NDBM(3X) NDBM(3X) 


NAME 
dbm_open, dbm_close, dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, 
dbm_nextkey, dbm_error, dbm_clearerr - database subroutines 


SYNOPSIS 
#include <ndbm.h> 


typedef struct { 
char *dptr; 
int dsize; 
} datum; 
DBM *dbm_open(file, flags, mode) 
char *file; 
int flags, mode; 


void dbm_close(db) 
DBM *db; 


datum dbm_fetch(db, key) 
DBM *db; 
datum key; 

int dbm_store(db, key, content, flags) 
DBM *db; “Te 
datum key, content; 
int flags; 

int dbm_delete(db, key) 
DBM *db; 
datum key; 

datum dbm _firstkey(db) 
DBM *db; 

datum dbm_nextkey(db) 
DBM *db; 

int dbm_error(db) 
DBM *db; 

int dbm_clearerr(db) 
DBM *db; 

DESCRIPTION 


These functions maintain key/content pairs in a database. The functions will 
handle very large (a billion blocks) databases and will access a keyed item in 
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one or two file system accesses. This package replaces, and is incompatible 
with, the earlier dbm(3x) library, which managed only a single database. 


keys and contents are described by the datum typedef. A datum specifies a 
string of dsize bytes pointed to by dpir. Arbitrary binary data, as well as normal 
ASCII strings, are allowed. The database is stored in two files. One file is a 
directory containing a bit map and has .dir as its suffix. The second file 
contains all data and has .pag as its suffix. 

Before a database can be accessed, it must be opened by dbm_open. This opens 
and/or creates the files file dir and file.pag depending on the flags parameter 
[see open(2)]. 


Once open, the data stored under a key is accessed by dbm_fetch and data is 
placed under a key by dbm_ store. The flags field can be either DBM INSERT 
or DBM_REPLACE. DBM_INSERT inserts only new entries into the database 
and does not change an existing entry with the same key. DBM_REPLACE 
replaces an existing entry if it has the same key. A key (and its associated 
contents) is deleted by dbm_ delete. A linear pass through all keys in a database 
can be made, in an (apparently) random order, by use of dbm_firstkey and 
dbm_nextkey. dbm_firstkey returns the first key in the database. dbm_nextkey 
returns the next key in the database. This code traverses the database: 


for key = dbm_firstkey(db); key.dptr l= NULL; key = dbm_nextkey(db) 


dbm_error returns non-zero when an error has occurred reading or writing the 
database. dbm_clearerr resets the error condition on the named database. 


SEE ALSO 
dbm(3X). 


DIAGNOSTICS 
All functions that return an int indicate errors with negative values. A zero 
return indicates no error condition. Routines that return a daturn indicate errors 
with a null (0) dptr. If, when dbm_ store is called with a flags value of 
DBM_INSERT, it finds an existing entry with the same key, it returns 1. 


WARNINGS 
The .pag file will contain holes so that its apparent size is about four times its 
actual content. Such a file cannot be copied by normal means (cp, cat, tp, tar, 
ar) without filling in the holes. 


dptr pointers returned by these subroutines point into static storage that is 
changed by subsequent calls. 


The sum of the sizes of a key/content pair must not exceed the internal block 
size (currently 4096 bytes). Moreover all key/content pairs that hash together 
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must fit on a single block. dbm_store will return an error in the event that a 
disk block fills with inseparable data. 


dbm_ delete does not physically reclaim file space, although it does make it 
available for reuse. 


The order of keys presented by dbm_firstkey and dbm_nextkey depends on a 
hashing function, not on anything interesting. 
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NAME 


nlist - get entries from name list 


SYNOPSIS 


#include <nlist.h> 


int nlist (filename, nl) 
char *filename; 
struct nlist *nl; 


DESCRIPTION 


nlist examines the name list in the executable file whose name 1s pointed to by 
filename and selectively extracts a list of values and puts them in the array of 
nlist structures pointed to by nl. The name list n/ consists of an array of 
structures containing names of variables, types, and values. The list is 
terminated with a null name; that is, a null string is in the name position of the 
structure. Each variable name is looked up in the name list of the file. If the 
name is found, the type and value of the name are inserted in the next two 
fields. The type field will be set to 0 unless the file was compiled with the -g 
option. If the name is not found, both entries are set to 0. See a.out(4) for a 
discussion of the symbol table structure. 


This function is useful for examining the system name list kept in the file /unix. 
In this way programs can obtain system addresses that are up to date. 


SEE ALSO 


a.out(4). 


DIAGNOSTICS 


NOTES 


All value entries are set to 0 if the file cannot be read or if it does not contain a 
valid name list. 


nlist returns -1 upon error; otherwise, it returns 0. 


The <nlist.h> header file is automatically included by <a.out.h> for 
compatibility. However, if the only information needed from <a.out.h> is for 
use of nlist, then including <a.out.h> is discouraged. If <a.out.h> is included, 
the line “‘#undef n_name’’ may need to follow it. 
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NAME 
nisgetcall - get client’s data passed through the listener 


SYNOPSIS 
#include <sys/tiuser.h> 


Struct t_call *nlsgetcall(fd); 
int fd; 
DESCRIPTION 


Nlsgeicall allows server processes started by the listener process to access the 
client’s ¢ call structure [that is, the sndcall argument of t connect (3N)]. 


The ¢_call structure returned by nlsgetcall can be released by using t free (3N). 


Nlsgetcall returns the address of an allocated ¢_call structure or NULL if a ¢ call 
structure cannot be allocated. If the t alloc succeeds, undefined environment 
variables are indicated by a negative len field in the appropriate netbuf 
structure. A len field of zero in the netbuf structure is valid and means that the 
original buffer in the listener’s ¢ call structure was NULL. 


FILES 
/usr/lib/libnsl_s.a 
/usr/lib/libnsl.a 


SEE ALSO 
nlsadmin(1M), getenv(3), t_connect(3N), t_alloc(3N), t_free(3N), t_error(3N). 


DIAGNOSTICS 
A NULL pointer is returned if ¢_alloc cannot allocate at call structure. Further 
error information can be found in ¢ errno. Undefined environment variables 
are indicated by a negative length field (/en) in the appropriate netbuf structure. 


CAVEATS 
The listener process limits the amount of user data (udata) and options data 
(opt) to 128 bytes each. Address data addr is limited to 64 bytes. If the original 
data was longer, no indication of overflow is given. 


NOTES 
Server processes must call t_sync(3N) before calling nisgetcall (3N). 


WARNING 
The len field in the netbuf structure is defined as being unsigned. In order to 
check for error returns, it should first be cast to an integer. 
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NAME 
nisprovider - get name of transport provider 


SYNOPSIS 
char *nlsprovider( ); 


DESCRIPTION 
Nlsprovider returns a pointer to a null terminated character string that contains 
the name of the transport provider as placed in the environment by the listener 
process. If the variable is not defined in the environment, a NULL pointer is 
returned. 


The environment variable is available only to server processes started by the 
listener process. 


SEE ALSO 
nisadmin(1M). 
DIAGNOSTICS 
If the variable is not defined in the environment, a NULL pointer is returned. 


FILES 
/usr/lib/libnsl.a 
fusr/lib/libnsl_s.a 
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NAME 


nlsrequest - format and send listener service request message 


SYNOPSIS 


#include <listen.h> 


int nlsrequest(fd, service code); 
int fd; 
char *service_ code; 


extern int _nislog, t_ errno; 
extern char * nisrmsg; 


DESCRIPTION 


FILES 


Given a virtual circuit to a listener process (fd) and a service code of a server 
process, nlsrequest formats and sends a service request message to the remote 
listener process, requesting that it start the given service. Nisrequest waits for 
the remote listener process to return a service request response message, made 
available to the caller in the static, null-terminated data buffer pointed to by 
_nlsrmsg. The service request response message includes a success or failure 
code and a text message. The entire message can be printed. 


/usr/lib/libnsl.a 
fusr/lib/libnsl_s.a 


SEE ALSO 


nisadmin(1M), t_error(3). 


DIAGNOSTICS 


The success or failure code is the integer return code from nlsrequest. Zero 
indicates success. Negative values such as the following indicate nlsrequest 
failures: 


-] Error encountered by nlsrequest, see t_errno. 


Postive values are error return codes from the listener process. Mnemonics for 
these codes are defined in listen.h. 


2 Request message not interpretable. 
3 Request service code unknown. 
4 Service code known, but currently disabled. 


If non-null, _nlsrmsg contains a pointer to a static, null-terminated character 
buffer containing the service request response message. Note that both 
_nilsrmsg and the data buffer are overwritten by each call to nlsrequest. 
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If _nlslog is non-zero, nisrequest prints error messages on stderr. Initially, 
_nislog is zero. 


WARNING 
Nlsrequest does not always ensure that the remote server process has been 
successfully started. If the process has not been started, nlsrequest returns with 
no indication of an error, and the caller receives notification of a disconnect 
event through a T_LOOK error before or during the first ¢_snd or t_rcv call. 
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NAME 
ocurse - optimized screen functions 


SYNOPSIS 
#include <ocurse.h> 


DESCRIPTION 
Ocurse is the old Berkeley curses library that uses termcap (4). 
should use curses (3X). 


Jew programs 


» 


These functions optimally update the screen. 
Each curses program begins by calling initscr and ends by calling endwin. 


Before a program can change a screen, it must specify the changes. It stores 
changes in a variable of type WINDOW by calling curses functions with the 
variable as argument. Once the variable contains all the changes desired, the 
program calls wrefresh to write the changes to the screen. 


Most programs need only a single WINDOW variable. Ocurse provides a 
standard WINDOW variable for this case and a group of functions that operate 
on it. The variable is called stdscr; its special functions have the same names as 
the general functions minus the initial w. 


FUNCTIONS 
addch(ch) Add a character to stdscr. 
addstr(str) Add a string to stdscr. 
box(win,vert,hor) Draw a box around a window. 
crmode( ) Set cbreak mode. 
clear() Clear stdscr. 
clearok(scr,boolf) Set clear flag for scr. 
cIrtobot( ) Clear to bottom on stdscr. 
cirtoeol( ) Clear to end of line on stdscr. 
delch( ) Delete a character. 
deleteln( ) Delete a line. 
delwin(win) Delete win. 
echo() Set echo mode. 
endwin() End window modes. 
erase( ) Erase stdscr. 
getch() Get a char through stdscr. 
getcap(name) Get terminal capability name. 
getstr(str) Get a string through stdscr. 
gettmode( ) Get tty modes. 
getyx(win,y,x) Get y and x coordinates. 
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inch() Get char at current y and x coordinates. 
initscr( ) Initialize screens. 

insch(c) Insert a char. 

insertin( ) Insert a line. 

leaveok(win,boolf) Set leave flag for win. 
longname(termbuf,name) Get long name from termbuf. 
move(y,x) Move to y and x coordinates on stdscr. 


mvcur(lasty,lastx,newy,newx) 

Actually move cursor. 
newwin(lines,cols,begin_y,begin_x) 

Create a new window. 


nl() Set newline mapping. 
nocrmode( ) Unset cbreak mode. 

noecho( ) Unset echo mode. 

nonl( ) Unset newline mapping. 
noraw( ) Unset raw mode. 
overlay(win1,win2) Overlay winl on win2. 
overwrite(win1,win2) Overwrite win] on top of win2. 
printw(fmt,arg1,arg2.. . .) Printf on stdscr. 

raw() Set raw mode. 

refresh( ) Make current screen look like stdscr. 
resetty() Reset tty flags to stored value. 
savetty() Store current tty flags. 

BR scanw (fmt,argl,arg2,...) Scanf through stdscr. 
scroll(win) Scroll win one line. 
scrollok(win,boolf) Set scroll flag. 

setterm(name) Set term variables for name. 
standend( ) End standout mode. 
standout() Start standout mode. 


subwin(win,lines,cols,begin_y,begin_x) 
Create a subwindow. 


touchwin(win) Change all of win. 
unctrl(ch) Printable version of ch. 
waddch(win,ch) Add char to win. 
waddstr(win,str) Add string to win. 
wclear(win) Clear win. 

welrtobot(win) Clear to bottom of win. 
weirtoeol(win) Clear to end of line on win. 
wdelch(win,c) Delete char from win. 
wdeleteln(win) Delete line from win. 
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werase(win) Erase win. 
wegetch(win) Get a char through win. 
weetstr(win,str) Get a string through win. 
winch(win) Get char at current y and x coordinates in win. 
winsch(win,c) Insert char into win. 
winsertin(win) Insert line into win. 
wmove(win,y,x) Set current y and x coordinates on win. 
wprintw(win,fmt,arg1,arg?2,. ..) 
Printf on win. 
wrefresh(win) Make screen look like win. 
wscanw(win,fmt,arg1,arg?2,. ..) 
Scanf through win. 
wstandend(win) End standout mode on win. 
wstandout(win) Start standout mode on win. 
FILES 
fusrfinclude/ocurse.h header file 
/usr/lib/libocurse.a curses library 
/usr/lib/libtermcap.a_ _termcap library, used by curses 
SEE ALSO 


stty(2), otermcap(3X), setenv(3), termcap(4). 
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NAME 
igetent, tgemum, tgetflag, tgetstr, tgoto, tputs - terminal independent operations 


SYNOPSIS 
char PC; 
char *BC; 
char *UP; 
short ospeed; 


tgetent(bp, name) 
char *bp, *name; 


tgetnum(id) 
char *id; 


tgetflag(id) 
char *id; 


char * 
tgetstr(id, area) 
char *id, **area; 


char * 
tgoto(cmstr, destcol, destline) 
char *cmstr; 


tputs(cp, affent, outc) 
register char *cp; 
int affcnt; 

int (*outc)(); 


DESCRIPTION 
These functions extract and use information from terminal descriptions that 
follow the conventions in termcap(4). The functions perform only basic screen 
manipulation: they find and output specified terminal function strings and 
interpret the cm string. The ocurse(3X) routine describes a screen updating 
package built on termcap. 


The tgetent routine finds and copies a terminal description. The name argument 
is the name of the description; bp points to a buffer to hold the description. The 
routine passes bp to the other termcap functions; the buffer must remain 
allocated until the program finishes with the termcap functions. 
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Tgetent uses the TERM and TERMCAP environment variables to locate the 
terminal description. 


* If TERMCAP isn’t set or is empty, tgefent searches for name in 
letc/termcap . 


e If TERMCAP contains the full pathname of a file (any string that 
begins with /), tgetent searches for name in that file. 


® If TERMCAP contains any string that does not begin with /, and TERM 
is not set or matches name, tgetent copies the TERMCAP string. 


@ If TERMCAP contains any string that does not begin with /, and TERM 
does not match name, tgetent searches for name in /etc/termcap. 


The tgefent routine returns -1 if it cannot open the terminal capability file; it 
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The tgetnum routine returns the value of the numeric capability whose name is 
id; It returns -1 if the terminal lacks the specified capability or if it is not a 
numeric capability. 


The tgefflag routine returns 1 if the terminal has boolean capability whose name 
is id; it returns 0 if it does not or it is not a boolean capability. 


The tgetstr routine copies and interprets the value of the string capability named 
by id. It expands instances in the string of \and *. It leaves the expanded string 
in the buffer .ul indirectly pointed to by area and leaves the buffer’s direct 
pointer pointing to the end of the expanded string. For example: 


tgetstr("cl", &ptr); 


where pir is a character pointer, not an array name. The fgetstr routine returns a 
(direct) pointer to the beginning of the string. 


The fgoto routine interprets the % escapes in a cm string. It returns cmstr with 
the % sequences changed to the position indicated by destcol and destline. This 
function must have the external variables BC and UP set to the values of the be 
and up capabilities; if the terminal lacks the capability, set the external variable 
to NULL. If tgoto cannot interpret all the % sequences in cm, it returns OPS. 


The fgoto routine avoids producing characters that might be misinterpreted by 
the terminal interface. If expanding a % sequence would produce a null or 
Control-D, the function tries to send the cursor to the next line or column and 
use BC or UP to move to the correct location. Note that tgoto does not avoid 
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producing tabs; a program must disable the TAB3 feature of the terminal 
interface [termio(7)). This is a good idea anyway: some terminals use the tab 
character as a nondestructive space. 


The ¢puts routine directs the output of a string returned by tgetstr or tgoto. This 
function must have the external variable PC set to the value of the pc 
capability; if the terminal lacks the capability, set the external variable to null. 
The tputs routine interprets any delay at the beginning of the string. The cp 
argument is the string to be output; affcnt is the number of lines affected by the 
action (1 if ‘‘number of lines affected’’ doesn’t mean anything); and outc points 
to a function that takes a single char argument and outputs it, such as putchar. 


FILES 
/usr/lib/libotermcap.a library 
/etc/termcap database 
SEE ALSO 


ex(1), ocurse(3X), termcap(4). 
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NAME 
perror, errno, sys_errlist, sys_nerr - system error messages 


SYNOPSIS 
void perror (s) 
char *s; 


extern int errno; 
extern char *sys errlist[ ]; 
extern int sys nerr; 


DESCRIPTION 

perror produces a message on the standard error output, describing the last 
error encountered during a call to a system or library function. The argument 
string s is printed first, then a colon and a blank, then the message and a 
newline. (However, if s="" the colon is not printed.) To be of most use, the 
argument string should include the name of the program that incurred the error. 
The error number is taken from the external variable errno, which is set when 
errors occur but not cleared when non-erroneous calls are made. 


To simplify variant formatting of messages, the array of message strings 
sys_errlist is provided; errno can be used as an index into this table to get the 
message string without the newline. sys_nerr is the number of messages in the 
table; it should be checked because new error codes may be added to the system 
before they are added to the table. 


SEE ALSO 
intro(2). 
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NAME 

plot - graphics interface subroutines 
SYNOPSIS 

openp! () 

erase () 

label (s) 

char *s; 

line (x1, yl, x2, y2) 

int x1, yl, x2, y2; 

circle (x, y, r) 

int x, y, r3 

arc (x, y, x0, yd, xi, yi) 

int x, y, x0, yO, x1, y1; 

move (x, y) 

int x, y; 


cont (x, y) 
int x, y; 
point (x, y) 
int x, y; 
linemod (s) 
char *s; 


space (x0, y0, x1, yl) 
int x0, yO, x1, yl; 


closepl () 


DESCRIPTION 
These subroutines generate graphic output in a relatively device-independent 
manner. The space routine must be used before any of these functions to 
declare the amount of space necessary [see plot(4)}. The openpl routine must 
be used before any of the others to open the device for writing. The closepl 
routine flushes the output. 


The circle routine draws a circle of radius r with center at the point (x, y). 


The arc routine draws an arc of a circle with center at the point (x, y) between 
the points (x0, yO) and (x, yl). 


String arguments to label and linemod are terminated by nulls and do not 
contain newlines characters. 
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See plot (4) for a description of the effect of the remaining functions. 
The library files listed below provide several flavors of these routines. 


— /usr/lib/libplot.a produces output for tplot (1G) filters 
/ust/lib/lib300.pa for DASI 300 
fusr/lib/lib300.a for DASI 300s 
fust/lib/lib450.a for DASI 450 
/usr/lib/lib4014.a for TEKTRONIX 4014 
fusr/lib/libgt.a for Convergent Technologies Graphics Terminal 
SEE ALSO 
grapn(iG), siai(iG), ipici(iG), piot(4). 
WARNINGS 


In order to compile a program containing these functions in file.c it is necessary 
to use ‘“cc file.c -Iplot’’. 


In order to execute it, it is necessary to use ‘‘a.out | tplot’’. 


The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O more than might be expected. 
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NAME 
popen, pclose - initiate pipe to/from a process 


SYNOPSIS 
#include <stdio.h> 


FILE *popen (command, type) 
char *command, *type; 


int pclose (stream) 
FILE *stream; 


DESCRIPTION 
The popen routine creates a pipe between the calling program and the 
command to be executed. The arguments to popen are pointers to null- 
terminated strings. The command argument consists of a shell command line: 
type is an I/O mode, either r for reading or w for writing. The value returned is 
a stream pointer such that one can write to the standard input of the command, 
if the I/O mode is w, by writing to the file stream; and one can read from the 
standard output of the command, if the /O mode is r, by reading from the file 
stream. 


A stream opened by popen should be closed by pclose, which waits for the 
associated process to terminate and returns the exit status of the command. 


Because open files are shared, a type r command can be used as an input filter 
and a type w as an output filter. 


EXAMPLE 
A typical cali can be the following: 


char «cmd = "is _ +.c"; 
FILE «ptr; 
if ((ptr = popen(cmd, "r")) != NULL) 
while (fgets(buf, n, ptr) != NULL) 
(void) printf ("%s “,buf); 


This prints in stdout [see stdio(3S)] all the file names in the current directory 
that have a °‘.c’’ suffix. 


SEE ALSO 
pipe(2), wait(2), fclose(3S), fopen(3S), stdio(3S), system(3S). 
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DIAGNOSTICS 
The popen routine returns a NULL pointer if files or processes cannot be 
created. 


The pclose routine returns -1 if stream is not associated with a popened 
command. 


WARNING 
If the original and popened processes concurrently read or write a common file, 
neither should use buffered VO because the buffering gets all mixed up. 
Problems with an output filter can be forestalled by careful buffer flushing; for 
example, with fflush [see fclose (3S)]. 
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NAME 
printf, fprintf, sprintf - print formatted output 


SYNOPSIS 
#include <stdio.h> 


int printf (format , arg... ) 
char *format; 


int fprintf (stream, format , arg ... ) 
FILE *stream; 
char *format; 


int sprintf (s, format [ , arg]... ) 
char *s, *format; 


DESCRIPTION 
printf places output on the standard output stream stdout. fprintf places output 
on the named output stream. sprintf places ‘‘output,’’ followed by the null 
character (\0), in consecutive bytes starting at *s; it is the user’s responsibility 
to ensure that enough storage is available. Each function returns the number of 
characters transmitted (not including the \0 in the case of sprintf), or a negative 
value if an output error was encountered. 


Each of these functions converts, formats, and prints its args under control of 
the format. The format is a character string that contains two types of objects: 
plain characters, which are simply copied to the output stream, and conversion 
specifications, each of which results in fetching of zero or more args. The 
results are undefined if there are insufficient args for the format. If the format 
is exhausted while args remain, the excess args are simply ignored. 


Each conversion specification is introduced by the character %. After the %, 
the following appear in sequence: 


e Zero or more flags, which modify the meaning of the conversion 
specification. 


° An optional decimal digit string specifying a minimum field width. If 
the converted value has fewer characters than the field width, it will be 
padded on the left (or right, if the left-adjustment flag (-), described 
below, has been given) to the field width. The padding is with blanks 
unless the field width digit string starts with a zero, in which case the 
padding is with zeros. 


° A precision that gives the minimum number of digits to appear for the 
d, i, 0, u, x, or X conversions, the number of digits to appear after the 
decimal point for the e, E, and f conversions, the maximum number of 
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significant digits for the g and G conversion, or the maximum number 
of characters to be printed from a string in s conversion. The precision 
takes the form of a period (.) followed by a decimal digit string; a null 
digit string is treated as zero. Padding specified by the precision 
overrides the padding specified by the field width. 


® An optional | (ell) specifying that a following d, i, 0, u, x, or X 
conversion character applies to a long integer arg. An I before any 
other conversion character is ignored. 


e A character that indicates the type of conversion to be applied. 


A field width or precision or both can be indicated by an asterisk (*) instead of 
a digit string. In this case, an integer arg supplies the field width or precision. 
The arg that is actually converted is not fetched until the conversion letter is 
seen, so the args specifying fieid widih or precision musi appear before the arg 
(if any) to be converted. A negative field width argument is taken asa (-) flag 
followed by a positive field width. If the precision argument is negative, it will 


be changed to zero. 
The flag characters and their meanings are: 
- The result of the conversion will be left-justified within the field. 


+ The result of a signed conversion will always begin with a sign (+ or 
-). 

blank _If the first character of a signed conversion is not a sign, a blank will 
be prefixed to the result. This implies that if the blank and + flags 
both appear, the blank flag will be ignored. 


# This flag specifies that the value is to be converted to an alternate 
form. For c, d, i, s, and u conversions, the flag has no effect. For o 
conversion, it increases the precision to force the first digit of the 
result to be a zero. For x or X conversion, a non-zero result will have 
0x or 0X prefixed to it. For e, E, f, g, and G conversions, the result 
will always contain a decimal point, even if no digits follow the point 
(normally, a decimal point appears in the result of these conversions 
only if a digit follows it). For g and G conversions, trailing zeroes 
will not be removed from the result (which they normally are). 


The conversion characters and their meanings are: 


d,i,0,u,x,X 
The integer arg is converted to signed decimal (d or i), unsigned 
octal, (0), decimal (u), or hexadecimal notation (x or X), respectively; 
the letters abcdef are used for x conversion and the letters ABCDEF 
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for X conversion. The precision specifies the minimum number of 
digits to appear; if the value being converted can be represented in 
fewer digits, it will be expanded with leading zeroes. The default 
precision is 1. The result of converting a zero value with a precision 
of zero is a null string. 


The float or double arg is converted to decimal notation in the style 
[-]ddd.ddd, where the number of digits after the decimal point is equal 
to the precision specification. If the precision is missing, six digits 
are Output; if the precision is explicitly 0, no decimal point appears. 


The float or double arg is converted in the style [-]d.dddetdd, where 
there is one digit before the decimal point and the number of digits 
after it is equal to the precision; when the precision is missing, six 
digits are produced; if the precision is zero, no decimal point annears. 
The E format code will produce a number with E instead of e 
introducing the exponent. The exponent always contains at least two 
digits. 

The float or double arg is printed in style f or e (or in style E in the 
case of a G format code), with the precision specifying the number of 
significant digits. The style used depends on the value converted: 
style e will be used only if the exponent resulting from the conversion 
is less than -4 or greater than the precision. Trailing zeroes are 
removed from the result; a decimal point appears only if it is followed 
by a digit. 


The character arg is printed. 


The arg is taken to be a string (character pointer) and characters from 
the string are printed until a null character (\0) is encountered or the 
number of characters indicated by the precision specification is 
reached. If the precision is missing, it is taken to be infinite, so all 
characters up to the first null character are printed. A NULL value for 
arg will yield undefined results. 


Print a %; no argument 1s converted. 
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In printing floating point types (float and double), if the exponent is Ox7FF and 
the mantissa is not equal to zero, then the output is 


[-]JNaNOxdddddddd 


where Oxdddddddd is the hexadecimal representation of the leftmost 32 bits of 
the mantissa. If the mantissa is zero, the output is 


(+]inf. 


In no case does a non-existent or small field width cause truncation of a field; if 
the result of a conversion is wider than the field width, the field is simply 
expanded to contain the conversion result. Characters generated by prinif and 
fprintf are printed as if putc (3S) had been called. 


EXAMPLES 
To print a date and time in the following form: Sunday, July 3, 10:02, where 
weekday and month are pointers to null-terminated strings: 


printf ("%s, %s %i, %d:%.2d", weekday, month, day, hour, min); 
To print 7 to 5 decimal places: 
printf("pi = %.5f", 4 * atan(1.0)); 


SEE ALSO 
ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 
putc, putchar, fputc, putw - put character or word on a stream 


SYNOPSIS 
#include <stdio.h> 


int putc (c, stream) 
int c; 
FILE *stream; 


int putchar (c) 
int ¢c; 


int fputc (c, stream) 
int c; 
FILE *stream; 


int putw (w, stream) 
int w; 
FILE *stream; 


DESCRIPTION 
putc writes the character c onto the output stream (at the position where the file 
pointer, if defined, is pointing). putchar(c) is defined as putc(c, stdout). putc 
and putchar are macros. 


fputc behaves like putc, but is a function rather than a macro. fputc runs more 
slowly than putc, but it takes less space per invocation and its name can be 
passed as an argument to a function. 


putw writes the word (that is, integer) w to the output stream (at the position at 
which the file pointer, if defined, is pointing). The size of a word is the size of 
an integer and varies from machine to machine. putw neither assumes nor 
Causes special alignment in the file. 


SEE ALSO 
fclose(3S), ferror(3S), fopen(3S), fread@GS), printf3S), puts(3S), setbuf(3S), 
stdio(3S). 


DIAGNOSTICS 
On success, these functions (with the exception of putw) each return the value 
they have written. [putw returns ferror (stream)]. On failure, they return the 
constant EOF. This will occur if the file stream is not open for writing or if the 
Output file cannot grow. Because EOF is a valid integer, ferror(3S) should be 
used to detect putw errors. 
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CAVEATS 
Because it is implemented as a macro, putc evaluates a stream argument more 
than once. In particular, putc(c, *f++); doesn’t work sensibly. fputc should be 
used instead. 


Because of possible differences in word length and byte ordering, files written 
using putw are machine-dependent, and cannot be read using getw on a 
different processor. 
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NAME 


putenv - change or add value to environment 


SYNOPSIS 


int puteny (string) 
char *string; 


DESCRIPTION 


string points to a string of the form name=value. putenv makes the value of the 
environment variable name equal to value by altering an existing variable or 
creating a new one. In either case, the string pointed to by string becomes part 
of the environment, so altering the string will change the environment. The 
space used by string is no longer used once a new string-defining name is 
passed to putenv. 


exec(2), getenv(3C), malloc(3C), environ(5). 


DIAGNOSTICS 


putenv retums non-zero if it was unable to obtain enough space via malloc for 
an expanded environment; otherwise, it returns zero. 


WARNINGS 


putenv manipulates the environment pointed to by environ, and can be used in 
conjunction with getenv. However, envp (the third argument to main) is not 
changed. 


This routine uses malloc (3C) to enlarge the environment. 


After putenv is called, environmental variables are not in alphabetical order. 
A potential error is to call putenv with an automatic variable as the argument, 
then exit from the calling function while string is still part of the environment. 
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NAME 
putpwent - write password file entry 


SYNOPSIS 
#include <pwd.h> 


int putpwent (p, f) 
struct passwd *p; 
FILE *f; 


DESCRIPTION 
The putpwent routine is the inverse of getpwent(3C). Given a pointer to a 
passwd structure created by getpwent (or getpwuid or getpwnam), putpwent 
writes a line on the stream f, which matches the format of /etc/passwd. 


SEE ALSO 
getpwent(3C), getspent(3X), putspent(3X). 

DIAGNOSTICS 
The putpwent routine returns non-zero if an error is detected during its 
operation; otherwise it returns zero. 


WARNING 
If a program not otherwise using standard I/O uses this routine, the size of the 
program increases more than might be expected. 
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NAME 
puts, fputs - put a string on a stream 


SYNOPSIS 
#include <stdio.h> 


int puts (s) 

char ¥*s; 

int fputs (s, stream) 

char *s; 

FILE *stream; 
DESCRIPTION 


puts writes the null-terminated string pointed to by s, followed by a newline 
character, to the standard output stream stdout. 


fputs writes the null-terminated string pointed to by s to the named output 
stream. 


Neither function writes the terminating null character. 


SEE ALSO 
ferror(3S), fopen(3S), fread(3S), printf(3S), putc(3S), stdioGS). 


DIAGNOSTICS 
Both routines return EOF on error. This will happen if the routines try to write 
on a file that has not been opened for writng. 


NOTES 
puts appends a newline character while fputs does not. 
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NAME 
putspent - write shadow password file entry 


SYNOPSIS 
#include <shadow.h> 


int putspent (p, fp) 
struct spwd *p; 
FILE *fp; 
DESCRIPTION 
The putspent routine is the inverse of getspent(3X). Given a pointer to a spwd 


structure created by the getspent routine (or the getspnam routine), the putspent 
routine writes a line on the stream fp, which matches the format of /etc/shadow. 


If the sp_min, sp_max, or sp Istchg field of the spwd structure is -1, the 
corresponding /etc/shadow field is cleared. 


SEE ALSO 
getpwent(3C), putpwent(3C), getspent(3X). 


DIAGNOSTICS 
The putspent routine returns non-zero if an error was detected during its 
operation; otherwise, it returns zero. 


WARNING 
If a program not otherwise using standard I/O uses this routine, the size of the 
program increases more than might be expected. 


This routine is for internal use only; compatibility is not guaranteed. 
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NAME 


qsort - quicker sort 


SYNOPSIS 


void qsort ((char *) base, nel, sizeof (+base), compar) 
unsigned nel; 
int (*compar){ ); 


DESCRIPTION 


NOTES 


qsort is an implementation of the quicker-sort algorithm. It sorts a table of data 
in place. 

base points to the element at the base of the table. mel is the number of 
elements in the table. compar is the name of the comparison function, which is 
called with two arguments that point to the elements being compared. The 
function must return an inieger giving the resulis of ine comparison: a negative, 
0, or positive return indicates to the sort that the first operand is less than, equal 
to, or greater than the second operand, respectively. 


The pointer to the base of the table should be of type pointer-to-element, and 
Cast to type pointer-to-character. 


The comparison function need not compare every byte, so arbitrary data may be 
contained in the elements in addition to the values being compared. 


The order in the output of two items which compare as equal is unpredictable. 


SEE ALSO 


sort(1), bsearch(3C), Isearch(3C), string(3C). 
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NAME 
rand, srand - simple random-number generator 


SYNOPSIS 
int rand ( ) 


void srand (seed) 
unsigned seed; 


DESCRIPTION 
The rand routine uses a muluplicative congruential random-number generator 
with period 2°? that returns successive pseudo-random numbers in the range 
from 0 to 2'>-1. 


The srand routine can be called at any time to reset the random-number 
generator to a random starting point. The generator is initially seeded with a 
value of 1. 

NOTES 


The spectral properties of rand are limited. The drand48(3C) routine provides 
a much better, though more elaborate, random-number generator. 


SEE ALSO 
drand48(3C). 
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NAME 


rcmd, rresvport, ruserok - routines for returning a stream to a remote command 


SYNOPSIS 


rcmd (ahost, inport, locuser, remuser, cmd, fd2p); 
char **ahost; 

unsigned short inport; 

char *locuser, *remuser, *cmd; 

int *fd2p; 


rresvport (port); 
int *port; 


ruserok (rhost, superuser, ruser, luser); 
char *rhost; 


inf superuser; 


char *ruser, *luser; 


DESCRIPTION 


The rcmd routine is used by the super-user to execute a command on a remote 
machine using an authentication scheme based on reserved port numbers. The 
rresvport routine returns a descriptor to a socket with an address in the 
privileged port space. The ruserok routine is used by servers to authenticate 
clients requesting service with rcmd. All three functions are present in the 
same file and are used by the rshd(1M) server (among others). 


The rcmd routine looks up the host *ahost using gethostbyname (3), returning -1 
if the host does not exist; otherwise, *ahost is set to the standard name of the 
host and a connection is established to a server residing at the well-known 
Internet port inport. 


If the call succeeds, a socket of type SOCK_STREAM is returned to the caller 
and given to the remote command as stdin and stdout. If fd2p is non-zero, an 
auxiliary channel to a control process is set up, and a descriptor for it is placed 
in *fd2p. The control process returns diagnostic output from the command 
(unit 2) on this channel and accepts bytes on this channel as being CTIX signal 
numbers, to be forwarded to the process group of the command. If fd2p is 0, the 
stderr (unit 2 of the remote command) is made the same as the stdout and no 
provision 1s made for sending arbitrary signals to the remote process, although 
you may be able to get its attention by using out-of-band data. 


The protocol is described in rshd(1M). 
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The rresvport routine is used to obtain a socket with a privileged address bound 
to it. This socket is suitable for use by rcmd and several other routines. 
Privileged addresses consist of a port in the range 0 to 1023. Only the super- 
user can bind an address of this sort to a socket. 


The ruserok routine takes a remote host’s name, as returned by a 
gethostbyname (3) routine, two user names, and a flag indicating if the local 
user’s name is the super-user. It then checks the files /etc/hosts.equiv and, 
possibly, .rhosts in the current working directory (normally the local user’s 
home directory) to see if the request for service is allowed. A 1 is returned if 
the machine name is listed in the hosts.equiv file or if the host and remote user 
name are found in the .rhosts file; otherwise, ruserok returns 0. If the superuser 
flag is 1, the checking of the host.equiv file is bypassed. 


SEE ALSO 


BUGS 


romd(1), rexecd(1M), rlogin(1), rlogind(1M), rshd(1M), rexec(3). 


There is no way to specify options to the socket call that remd makes. 
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NAME 


regcmp, regex - compile and execute regular expression 


SYNOPSIS 


char «regcmp (string! [, string2, ...}, (char *)0) 
char *string1, *string2, ...; 


char *regex (re, subject[, ret0, ...]) 
char +re, *subject, *ret0, ...; 


extern char *__locl; 


DESCRIPTION 


regcmp compiles a regular expression (consisting of the concatenated 
arguments) and returns a pointer to the compiled form. malloc (3C) is used to 
create space for the compiled form. It is the user’s responsibility to free 
unneeded space so allocated. A NULL return from regcmp indicates an 
incorrect argument. regcmp(1) has been written to generally preclude the need 
for this routine at execution time. 


regex executes a compiled pattern against the subject string. Additional 
arguments are passed to receive values back. regex returns NULL on failure or 
a pointer to the next unmatched character on success. A global character 
pointer _locl points to where the match began. regcmp and regex were 
mostly borrowed from the editor, ed(1); however, the syntax and semantics 
have been changed slightly. The following are the valid symbols and their 
associated meanings. 


C1. These symbols retain their meaning in ed(1). 
$ Matches the end of the string; \n matches a newline. 


- Within brackets the minus means through. For example, 
[a-z] is equivalent to [abcd...xyz]. The - can appear as 
itself only if used as the first or last character. For example, 
the character class expression []-] matches the characters 
] and -. 


+ A regular expression followed by + means one or more 
times. For example, [0-9]+ is equivalent to [0-9] [0-9}+. 


{m} {m,}{m,u} Integer values enclosed in {} indicate the number of times 
the preceding regular expression is to be applied. The value 
m is the minimum number and u is a number, less than 256, 
which is the maximum. If only m is present (for example, 
{m}), it indicates the exact number of times the regular 
expression is to be applied. The value {m,} is analogous to 
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{m,infinity}. The plus (+) and star (*) operations are 
equivalent to {1,} and (0,} respectively. 

(...)$n The value of the enclosed regular expression is to be 
returned. The value will be stored in the (n+/)th argument 
following the subject argument. At most ten enclosed 
regular expressions are allowed. regex makes its 
assignments unconditionally. 


(264) Parentheses are used for grouping. An operator, for example, 
+, +, {}, can work on a single character or a regular 
expression enclosed in_ parentheses. For example, 
(a*(cb+)*)$0. 


By necessity, all the above defined symbols are special. They must, therefore, 
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This example matches a leading newline in the subject string pointed at by 
cursor: 


char *cursor, *newcursor, «ptr; 


newcursor = regex((ptr = regemp(""\n"", (char *)0)), cursor); 


free(ptr); 


This example matches through the string “‘Testing3’’ and returns the address of 
the character after the last matched character (the ‘*4’’). The string “‘Testing3’’ 
is copied to the character array ret0: 


char ret0[9]; 
char *newcursor, «name; 


name = regomp("([A-Za-z][A-za-z0-9]{0,7})$0", (char *)0); 
newcursor = regex(name, "012Testing345", ret0); 


This example applies a precompiled regular expression in file.i [see regcmp(1)] 
against string: 


char «string, *newcursor; 
newcursor = regex(name, string); 


These routines are kept in /lib/ibPW. a. 
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SEE ALSO 
ed(1), regemp(1), malloc(3C), regexp(5). 


BUGS 
The user program may run out of memory if regcmp is called iteratively 
without freeing the vectors no longer required. 
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NAME 
res_mkquery, res_send, res_init, dn_comp, dn_expand - resolver routines 


SYNOPSIS 
#include <sys/types.h> 
#include <netinet/in.h> 
#include <arpa/nameser.h> 
#include <resolv.h> 


res mkquery(op, dname, class, type, data, datalen, newrr, buf, buflen) 
int op; 

char *dname; 

int class, type; 

char *data; 

int datalen; 

Struct rrec *newrr; 

char *buf; 

int buflen; 


res_send(msg, msglen, answer, anslen) 
char *msg; 

int msglen; 

char *answer; 

int anslen; 


res_init() 


dn_comp(exp_ dn, comp dn, length, dnptrs, lastdnptr) 
char *exp dn, *comp dn; 

int length; 

char **dnptrs, **lastdnptr; 


dn_expand(msg, eomorig, comp dn, exp dn, length) 
char *msg, *eomorig, *comp dn, exp dn; 
int length; 


DESCRIPTION 
These routines are used for making, sending and interpreting packets to Internet 
domain name servers. Global information that is used by the resolver routines is 
kept in the variable res. Most of the values have reasonable defaults and can 
be ignored. Options stored in _res.options are defined in resolv.h and are as 
follows. Options are a simple bit mask and are ORed in to enable. 


RES_INIT True if the initial name server address and default domain 
name are initialized (that 1s, res init has been called). 
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RES_DEBUG Print debugging messages. 


RES_AAONLY Accept authoritative answers only. res send will 
continue until it finds an authoritative answer or finds an 
error. Currently this is not implemented. 


RES _USEVC Use TCP connections for queries instead of UDP. 


RES STAYOPEN Used with RES_USEVC to keep the TCP connection open 
between queries. This is useful only in programs that 
regularly do many queries. UDP should be the normal 


mode used. 

RES_IGNTC Unused currently (ignore truncation errors, that is, don’t 
retry with TCP). 

RES_RECURSE Set the recursion desired bit in queries. This is the 


default. (res_send does not do iterative queries and 
expects the name server to handle recursion.) 


RES DEFNAMES Append the default domain name to single label queries. 
This is the default. 


res init reads the initialization file, /etc/resolv.conf, to get the default domain 
name and the Internet address of the initial hosts running the name server. If 
the keyword usefile is present, no attempt is made to contact a name server, and 
the /etc/hosts file is used. If the nameserver line does not exist, the host 
running the resolver is tried. (The current domain name is determined 
according to the following search scheme: first, res_init checks the value of the 
environment variable LOCALDOMAIN, and the value is used if this variable is 
set; if there is no value for LOCALDOMAIN, res_init checks the file 
/etc/resolv.conf for a domain specification [see named(1M) and resolver (4)], 
and the value is used if it can be obtained; if neither of the first two searches is 
successful, res init uses the value specified in the start-up file 
/etc/rcopts/INET-DOMAIN if that file exists and contains a valid value.) 


res mkquery makes a standard query message and places it in buf. 
res_mkquery will return the size of the query or -1 if the query is larger than 
buflen. op is usually QUERY but can be any of the query types defined in 
nameser.h. dname is the domain name. If dname consists of a single label and 
the RES_DEFNAMES flag is enabled (the default), dname will be appended with 
the current domain name (determined in res init). newrr is currently unused 
but is intended for making update messages. 
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FILES 


res_send sends a query to name servers and returns an answer. It will call 
res init if RES_INIT is not set, send the query to the local name server, and 
handle timeouts and retries. The length of the message is returned or -1 if there 
were errors. 


dn_expand expands the compressed domain name comp_dn to a full domain 
name. Expanded names are converted to upper case. msg is a pointer to the 
beginning of the message, exp_dn is a pointer to a buffer of size length for the 
result. The size of compressed name is returned or -1 1f there was an error. 


dn_comp compresses the domain name exp_dn and stores it in comp_dn. The 
size of the compressed name is returned or -1 if there were errors. length is the 
size of the comp_dn. dnptrs is a list of pointers to previously compressed names 
in the current message. The first pointer points to to the beginning of the 
message and the list ends with NULL. lastdnpir is a pointer to the end of the 
aifay poinied to dnpirs. A side etiect is to update the list of pointers for labels 
inserted into the message by dn_comp as the name is compressed. If dnptr is 
NULL, we don’t try to compress names. If lastdnpir is NULL, we don’t update 
the list. 


/etc/resolv.conf 


SEE ALSO 


named(1M), resolver(4). 
CTIX Network Administrator's Guide. 
CTIX Network Programmer s Primer. 
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NAME 


rexec - return stream to a remote command 


SYNOPSIS 


rexec (ahost, inport, user, passwd, cmd, fd2p); 
char **ahost; 

unsigned short inport; 

char *user, *passwd, *cmd; 

int *fd2p; 


DESCRIPTION 


rexec looks up the host *ahost using gethostbyname (3), returning -1 if the host 
does not exist. Otherwise, *ahost is set to the standard name of the host. If a 
user name and password are both specified, then these are used to authenticate 
to the foreign host; otherwise, the environment and then the user’s -netre file in 
his home directory are searched for appropriate information. If all this fails, the 
user is prompted for the information. 


The port inport specifies which well-known DARPA Internet port to use for the 
connection; it will normally be the value returned from the call 
getnameserv("exec", "tcp") [see getservent(3)]. The protocol for connection 
is described in rexecd(1M). 


If the call succeeds, a socket of type SOCK_STREAM is returned to the caller 
and given to the remote command as stdin and stdout. If fd2p is non-zero, then 
an auxiliary channel to a control process will be set up, and a descriptor for it 
will be placed in *fd2p. The control process will return diagnostic output from 
the command (unit 2) on this channel and will also accept bytes on this channel 
as being CTIX signal numbers, to be forwarded to the process group of the 
command. If fd2p is 0, then the stderr (unit 2 of the remote command) will be 
made the same as the stdout and no provision is made for sending arbitrary 
signals to the remote process, although you may be able to get its attention by 
using out-of-band data. 


SEE ALSO 


BUGS 


rexecd(1M), remd(3), gethostbyname(3). 


There is no way to specify options to the socket call which rexec makes. 


ert i ae 


SCANF (35S) SCANF(3S) 


NAME 


scanf, fscanf, sscanf - convert formatted input 


SYNOPSIS 


#include <stdio.h> 


int scanf (format [ , pointer]... ) 
char *format; 


int fscanf (stream, format [ , pointer]... ) 
FILE *stream; 
char *format; 


int sscanf (s, format [ , pointer]... )} 
char *s, *format; 


DESCRIPTION 


scanf reads from the standard input stream stdin. fscanf reads from the named 
input stream. sscanf reads from the character string s. Each function reads 
characters, interprets them according to a format, and stores the results in its 
arguments. Each expects, as arguments, a control string format described 
below, and a set of pointer arguments indicating where the converted input 
should be stored. The results are undefined in that there are insufficient args 
for the format. If the format is exhausted while args remain, the excess args 
are simply ignored. 

The control string usually contains conversion specifications, which are used to 
direct interpretation of input sequences. The control string can contain: 


1, White-space characters (blanks, tabs, newlines, or form-feeds) which, 
except in two cases described below, cause input to be read up to the 
next non-white-space character. 


Zz An ordinary character (not %), that must match the next character of 
the input stream. 
3. Conversion specifications, consisting of the character %, an optional 


assignment suppressing character *, an optional numerical maximum 
field width, an optional | (ell) or h indicating the size of the receiving 
variable, and a conversion code. 


A conversion specification directs the conversion of the next input field; the 
result is placed in the variable pointed to by the corresponding argument, unless 
assignment suppression was indicated by *. The suppression of assignment 
provides a way of describing an input field that is to be skipped. An input field 
is defined as a string of non-space characters; it extends to the next 
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inappropriate character or until the field width, if specified, is exhausted. For 
all descriptors except [ and c, white space leading an input field is ignored. 


The conversion code indicates the interpretation of the input field; the 
corresponding pointer argument must usually be of a restricted type. For a 
suppressed field, no pointer argument is given. The following conversion codes 
are legal: 


% 


efig 


A single % is expected in the input at this point; no assignment is 
done. 


A decimal integer is expected; the corresponding argument should be 
an integer pointer. 


An unsigned decimal integer is expected; the corresponding argument 
should be an unsigned integer pointer. 


An octal integer is expected; the corresponding argument should be an 
integer pointer. 


A hexadecimal integer is expected; the corresponding argument should 
be an integer pointer. 


An integer is expected; the corresponding argument should be an 
integer pointer. It will store the value of the next input item interpreted 
according to C conventions: a leading 0 implies octal; a leading 0x 
implies hexadecimal; otherwise, decimal. 


Stores in an integer argument the total number of characters (including 
white space) that have been scanned so far since the function call. No 
input is consumed. 


A floating point number is expected; the next field is converted 
accordingly and stored through the corresponding argument, which 
should be a pointer to a float. The input format for floating point 
numbers is an optionally signed string of digits, possibly containing a 
decimal point, followed by an optional exponent field consisting of an 
E or an e, followed by an optional +, -, or space, followed by an 
integer. 


A character string is expected; the corresponding argument should be a 
character pointer pointing to an array of characters large enough to 
accept the string and a terminating \0, which will be added 
automatically. The input field is terminated by a white-space 
character. 


A character is expected; the corresponding argument should be a 
character pointer. The normal skip over white space is suppressed in 
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this case; to read the next non-space character, use %l1s. If a field 
width is given, the corresponding argument should refer to a character 
array; the indicated number of characters is read. 


Indicates string data and the normal skip over leading white space is 
suppressed. The left bracket is followed by a set of characters, called 
the scanset, and a right bracket; the input field is the maximal 
sequence of input characters consisting entirely of characters in the 
scanset. The circumflex (*), when it appears as the first character in 
the scanset, serves as a complement operator and redefines the scanset 
as the set of all characters not contained in the remainder of the scanset 
string. 


There are some conventions used in the construction of the scanset. A 
range of characters can be represented by the construct first-last; thus, 
[0123456789] can be expressed [0-9]. Using this convention, first 
must be lexically less than or equal to /ast, or else the dash will stand 
for itself. The dash will also stand for itself whenever it is the first or 
the last character in the scanset. To include the right square bracket as 
an element of the scanset, it must appear as the first character (possibly 
preceded by a circumflex) of the scanset, and in this case it will not be 
syntactically interpreted as the closing bracket. The corresponding 
argument must point to a character array large enough to hold the data 
field and the terminating \0, which will be added automatically. At 
least one character must match for this conversion to be considered 
successful. 


The conversion characters d, u, 0, x and i can be preceded by I or h to indicate 
that a pointer to long or to short rather than to int is in the argument list. 
Similarly, the conversion characters e, f, and g can be preceded by I to indicate 
that a pointer to double rather than to float is in the argument list. The | or h 
modifier is ignored for other conversion characters. 


scanf conversion terminates at EOF, at the end of the control string, or when an 
input character conflicts with the control string. In the latter case, the offending 
character is left unread in the input stream. 


scanf returns the number of successfully matched and assigned input items; this 
number can be zero in the event of an early conflict between an input character 
and the control string. If the input ends before the first conflict or conversion, 
EOF is returned. 
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EXAMPLES 
The call: 


int n; float x; char name{50]; 

n = scanf("“%d%f%s", &I, &x, name); 
with the input line: 

25 54.32E-1 thompson 


will assign to 7 the value 3, to i the value 25, to x the value 5.432, and name 
will contain thompson\0 . Or: 


int i, j; float x; char name{[50]; 

(void) scanf("%I%2d%f%+d %[0-9] “, &j, &i, &x, name); 
with input: 

011 56789 0123 56a72 


will assign 9 to j, 56 to i, 789.0 to x, skip 0123, and place the string 56\0 in 
name. The next call to getchar [see getc (3S)] will return a. Or: 


int I, j, 8, e; char name[50]; 
(void) scanf("%i %I %n%s%n"", &i, &j, &s, name, &e); 


with input: 
0x11 Oxy johnson 
will assign 17 to i, 0 to j, 6 to s, will place the string xy\0 in name, and will 
assign 8 to e. Thus, the length of name is e - s= 2. The next call to getchar 
[see getc (3S)] will return a blank. 
SEE ALSO 
getc(3S), printf(3S), stdio(3S), strtod(3C), strtol(3C). 


DIAGNOSTICS 
These functions retum EOF on end of input and a short count for missing or 
illegal data items. 


CAVEATS 
Trailing white space (including a newline) is left unread unless matched in the 
control string. 
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NAME 
setbuf, setvbuf - assign buffering to a stream 


SYNOPSIS 
#include <stdio.h> 


void setbuf (stream, buf) 
FILE *stream; 
char *buf; 


int setvbuf (stream, buf, type, size) 
FILE *stream; 
char *buf; 
int type, size; 

DESCRIPTION 
setbuf can be used after a stream has been opened but before it is read or 
written. It causes the array pointed to by buf to be used instead of an 
automatically allocated buffer. If buf is the NULL pointer, input/output will be 
completely unbuffered. 


A constant BUFSIZ, defined in the <stdio.h> header file, tells the size of the 
array needed: 


char buf[BUFSIZ]; 


setvbuf can be used after a stream has been opened but before it is read or 
written. Type determines how stream will be buffered. Legal values for type 


(defined in stdio.h) are: 

_IOFBF Causes input/output to be fully buffered. 

_IOLBF Causes output to be line buffered; the buffer will be flushed 
when a newline is written, the buffer is full, or input is 
requested. 

_IONBF Causes input/output to be completely unbuffered. 


If buf is not the NULL pointer, the array it points to will be used for buffering, 
instead of an automatically allocated buffer. Size specifies the size of the 
buffer to be used. The constant BUFSIZ in <stdio.h> is suggested as a good 
buffer size. If input/output is unbuffered, buf and size are ignored. 


By default, output to a terminal is line buffered and all other input/output is 
fully buffered. 


SEE ALSO 
fopen(3S), getc(3S), malloc(3C), putc(3S), stdio(3S). 
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DIAGNOSTICS 
If an illegal value for type or size is provided, setvbuf returns a non-zero value. 
Otherwise, the value returned will be zero. 


NOTES 
A common source of error is allocating buffer space as an automatic variable in 
a code block, and then failing to close the stream in the same block. 
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NAME 
setjmp, longjmp - non-local goto 


SYNOPSIS 
#include <setjmp.h> 


int setjmp (env) 
jmp _buf env; 


void longjmp (env, val) 
jmp_buf env; 
int val; 


DESCRIPTION 
These functions are useful for dealing with errors and interrupts encountered in 
a low-level subroutine of a program. 


setjmp saves its stack environment in env (whose type, jmp_buf, is defined in 
the <setjmp.h> header file) for later use by longjmp. It returns the value 0. 


longjmp restores the environment saved by the last call of setjmp with the 
corresponding env argument. After longjmp is completed, program execution 
continues as if the corresponding call of setjmp (which must not itself have 
returned in the interim) had just returned the value val. longjmp cannot cause 
setjmp to return the value 0. If longjmp is invoked with a second argument of 
0, setimp will return 1. At the time of the second return from setjmp, all 
external and static variables have values as of the time longjmp is called (see 
example). The values of register and automatic variables are undefined. 


In a future release, C language users will be able to idenufy syntactically those 
automatic variables on whose values they need to rely after the second return 
from setjmp. 


EXAMPLE 
#include <setjmp.h> 


jmp_buf env; 
inti =0; 
main () 


{ 
void exit(); 


if(setimp(env) != 0) { 
(void) printf(“value of i on 2nd return from 
setimp: %din”, §); 
exit(0); 
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(void) printf("value of | on 1st return from setjmp: 


%edin”, i); 
f=1: 
g{); 
/*NOTREACHED+/ 
} 
g() 
{ 
long/mp(eny, 1); 
/*NOTREACHED+/ 
} 


If the a.out resulting from this C language code is run, the output will be: 
value of i on Ist return from setjmp: 0 
value of i on 2nd return from setjmp: 1 


SEE ALSO 
signal(2). 
WARNING 


If longjmp is called even though env was never primed by a call to setjmp, or 
when the last such call was in a function that has since returned, absolute chaos 


is guaranteed. 
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NAME 
sinh, cosh, tanh - hyperbolic functions 


SYNOPSIS 
#include <math.h> 


double sinh (x) 
double x; 


double cosh (x) 
double x; 


double tanh (x) 
double x; 
DESCRIPTION 
sinh, cosh, and tanh return, respectively 
tangent of their argument. 
SEE ALSO 
matherr(3M). 


DIAGNOSTICS 
sinh and cosh return HUGE (and sinh may return -HUGE for negative x) when 
the correct value would overflow and set errno to ERANGE. 


a 7 pa nie wt 
aw aaj a UOC Sind, cosine ailKtl 


These error-handling procedures may be changed with the function 
matherr (3M). 
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NAME 
sleep - suspend execution for interval 


SYNOPSIS 
unsigned sleep (seconds) 
unsigned seconds; 


DESCRIPTION 

The current process is suspended from execution for the number of seconds 
specified by the argument. The actual suspension time may be less than that 
requested for two reasons: (1) Because scheduled wakeups occur at fixed 
one-second intervals, (on the second, according to an internal clock) and (2) 
because any caught signal will terminate the sleep following execution of that 
signal’s catching routine. Also, the suspension time may be longer than 
requested by an arbitrary amount due to the scheduling of other activity in the 
system. The value returned by sleep will be the ‘“‘unslept’’ amount (the 
requested time minus the time actually slept) in case the caller had an alarm set 
to go off earlier than the end of the requested sleep time, or premature arousal 
due to another caught signal. 


The routine is implemented by setting an alarm signal and pausing until it (or 
some other signal) occurs. The previous state of the alarm signal is saved and 
restored. The calling program may have set up an alarm signal before calling 
sleep. Xf the sleep time exceeds the time till such alarm signal, the process 
Sleeps only until the alarm signal would have occurred. The caller’s alarm 
catch routine is executed just before the sleep routine returns. But if the sleep 
time is less than the time till such alarm, the prior alarm time is reset to go off at 
the same time it would have without the intervening sleep. 


SEE ALSO 
alarm(2), pause(2), signal(2). 
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NAME 
sputl, sgetl - access long integer data in a machine-independent fashion 


SYNOPSIS 
void sputl (value, buffer) 
long value; 
char *buffer; 


long sgetl (buffer) 
char *buffer; 


DESCRIPTION 
sputl takes the four bytes of the long integer value and places them in memory 
Starting at the address pointed to by buffer. The ordering of the bytes is the 
same across all machines. 


sgetl retrieves the four bytes in memory starting at the address pointed to by 
buffer and returns the long integer value in the byte ordering of the host 
machine. 


The combination of sputl and sgetl provides a machine-independent way of 
storing long numeric data in a file in binary form without conversion to 
characters. 


A program that uses these functions must be loaded with the object-file access 
routine library libld.a. 
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NAME 
ssignal, gsignal - software signals 


SYNOPSIS 
#include <signal.h> 


int (*ssignal (sig, action))( ) 
int sig, (*action)( ); 
int gsignal (sig) 
int sig; 

DESCRIPTION 
ssignal and gsignal implement a software facility similar to signal(2). This 
facility is used by the Standard C Library to enable users to indicate the 
disposition of error conditions, and is also made available to users for their own 
purposes. 
Software signals made available to users are associated with integers in the 
inclusive range | through 16. A call to ssignal associates a procedure, action, 
with the software signal sig; the software signal, sig, is raised by a call to 
gsignal. Raising a software signal causes the action established for that signal 
to be taken. 


The first argument to ssignal is a number identifying the type of signal for 
which an action is to be established. The second argument defines the action; it 
is either the name of a (user-defined) action function or one of the manifest 
constants SIG_DFL (default) or SIG_IGN (ignore). ssignal returns the action 
previously established for that signal type; if no action has been established or 
the signal number is illegal, ssignal returns SIG_DFL. 


gsignal raises the signal identified by its argument, sig: 


e If an action function has been established for sig, then that action is 
reset to SIG_DFL and the action function is entered with argument sig. 
gsignal returns the value returned to it by the action function. 


° If the action for sig is SIG_IGN, gsignal returns the value 1 and takes 
no other action. 


° If the action for sig is SIG_DFL, gsignal returns the value 0 and takes 
no other action. 

e If stg has an illegal value or no action was ever specified for sig, 
gsignal returns the value 0 and takes no other action. 


SEE ALSO 
signal(2), sigset(2). 
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NOTES 


There are some additional signals with numbers outside the range 1 through 16 
which are used by the Standard C Library to indicate error conditions. Thus, 
some signal numbers outside the range 1 through 16 are legal, although their 
use may interfere with the operation of the Standard C Library. 
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NAME 


stdio - standard buffered input/output package 


SYNOPSIS 


#include <stdio.h> 
FILE *stdin, *stdout, *stderr; 


DESCRIPTION 


The functions described in the entries of sub-class 3S of this manual constitute 
an efficient, user-level 1/O buffering scheme. The in-line macros getc (3S) and 
putc(3S) handle characters quickly. The macros getchar and putchar, and the 
higher-level routines fgetc, fgets, fprintf, fputc, fputs, fread, fscanf, fwrite, 
gets, getw, printf, puts, putw, and scanf all use or act as if they use getc and 
putc; they can be intermixed freely. 


A file with associated buffering is called a stream and is declared to be a 
pointer to a defined type FILE. fopen(3S) creates certain descriptive data for a 
Stream and returns a pointer to designate the stream in all further transactions. 
Normally, there are three open streams with constant pointers declared in the 
<stdio.h> header file and associated with the standard open files: 


stdin standard input file 
stdout Standard output file 
stderr standard error file 


A constant NULL (0) designates a nonexistent pointer. 


An integer-constant EOF (-1) is returned upon end-of-file or error by most 
integer functions that deal with streams (see the individual descriptions for 
details). 


An inieger constant BUFSIZ specifies the size of the buffers used by the 
particular implementation. 


Any program that uses this package must include the header file of pertinent 
macro definitions, as follows: 


#include <stdio.h> 


The functions and constants mentioned in the entries of sub-class 3S of this 
manual are declared in that header file and need no further declaration. The 
constants and the following functions are implemented as macros (redeclaration 
of these names is perilous): getc, getchar , putc , putchar , ferror, feof, clearerr, 
and fileno . 


Output streams, with the exception of the standard error stream stderr, are by 
default buffered if the output refers to a file and line-buffered if the output 
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refers to a terminal. The standard error output stream stderr is by default 
unbuffered, but use of freopen [see fopen(3S)] will cause it to become buffered 
or line-buffered. When an output stream is unbuffered, information is queued 
for writing on the destination file or terminal as soon as written; when it is 
buffered, many characters are saved up and written as a block. When it is line- 
buffered, each line of output is queued for writing on the destination terminal as 
soon as the line is completed (that is, as soon as a newline character is written 
or terminal input is requested). setbuf(3S) or setvbuf() in setbuf(3S) can be 
used to change the stream’s buffering strategy. 


SEE ALSO 
close(2), lseek(2), open(2), pipe(2), read(2), write(2), ctermid(3S), cuserid(3S), 
fclose(3S), ferror(3S), fopen(3S), fread@GS), fseek(3S), getc(3S), gets(3S), 
popen(3S), printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), system(3S), 
tmpfile(3S), tmpnam(3S), ungetc(3S). 

DIAGNOSTICS 
Invalid stream pointers will usually cause grave disorder, possibly including 
program termination. Individual function descriptions describe the possible 
error conditions. 
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NAME 


sidipc, ftok - standard interprocess communication package 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
key t ftok(path, id) 
char *path; 

char id; 


DESCRIPTION 


All interprocess communication facilities require the user to supply a key to be 
used by the msgget(2), semget(2), and shmget(2) system calls to obtain 
interprocess communication identifiers. One suggested method for forming a 
key is to use the fiok subroutine described below. Another way to compose 
keys is to include the project ID in the most significant byte and to use the 
remaining portion as a sequence number. There are many other ways to form 
keys, but each system must define standards for forming them. If some standard 
is not adhered to, unrelated processes can unintentionally interfere with 
another’s operation. Therefore, it is recommended that the most significant 
byte of a key in some sense refer to a project so that keys do not conflict across 
a given system. 


ftok returns a key based on path and id that is usable in subsequent msgget, 
semget, and shmget system calls. Path must be the path name of an existing file 
that is accessible to the process. Jd is a character which uniquely identifies a 
project. Note that ftok will return the same key for linked files when called 
with the same id and that it will return different keys when called with the same 
file name but different ids. 


SEE ALSO 


intro(2), msgget(2), semget(2), shmget(2). 


DIAGNOSTICS 


ftok returns (key_t) -1 if path does not exist or if it is not accessible to the 
process. 


WARNING 


If the file whose path is passed to ftok is removed when keys still refer to the 
file, future calls to ftok with the same path and id will return an error. If the 
same file is recreated, then ftok is likely to return a different key than it did 
when it was called originally. 
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NAME 
string: strcat, strdup, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, 
strrchr, strpbrk, strspn, strcspn, strtok - string operations 


SYNOPSIS 
#include <string.h> 
#include <sys/types.h> 


char *strcat (Sl, s2) 
char *sl, *s2; 


char *strdup (sl) 
char *s]; 


char *strncat (s1, s2, n) 
char *sl, *s2; 

size_t n; 

int stremp (sl, s2) 

char *sI, *s2; 


int strncmp (sl, s2, n) 
char *sl1, *s2; 

size_t D; 

char *strcpy (s1, s2) 
char *sl, *s2; 


char *strncpy (s1, s2, n) 
char *sl, #52; 

size_t n; 

int strlen (s) 

char *s; 


char *strchr (s, c) 
char *s; 

int c; 

char *strrchr (s, c) 
char *s; 

int c; 

char *strpbrk (sl, s2) 
char *s1, *s2; 


int strspn (si, s2) 
char *sI, *s2; 
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int strcspn (s1, s2) 
char *sl1, *s2; 


char *strtok (s1, s2) 
char *s1, *s2; 


DESCRIPTION 
The arguments s1, s2 and s point to strings (arrays of characters terminated by a 
null character). The functions strcat, strncat, strcpy, and strncpy all alter s1. 
These functions do not check for overflow of the array pointed to by s1. 


The strcat routine appends a copy of string s2 to the end of string s1. 


The strdup routine returns a pointer to a new string which 1s a duplicate of the 
string pointed to by sl. The space for the new string is obtained using 
malloc(3C). If the new string can not be created, null is returned. 


The strncat routine appends at most n characters. Each returns a pointer to the 
null-terminated result. 


The strcmp routine compares its arguments and returns an integer less than, 
equal to, or greater than 0, according as sI is lexicographically less than, equal 
to, or greater than s2. The strncmp routine makes the same comparison but 
looks at at most n characters. 


The strcpy routine copies string s2 to sl, stopping after the null character has 
been copied. The strncpy routine copies exactly n characters, truncating s2 or 
adding null characters to s1 if necessary The result is not null-terminated if the 
length of s2 is n or more. Each function returns s1. 


The strlen routine returns the number of characters in s, not including the 
terminating null character. 


The strchr (strrchr) routine returns a pointer to the first (last) occurrence of 
character c in string s, or a NULL pointer if ¢ does not occur in the string. The 
null character terminating a string is considered to be part of the string. 


The strpbrk routine returns a pointer to the first occurrence in string sl of any 
character from string s2, or a NULL pointer if no character from s2 exists in s1. 


The strspn (strcspn) routine returns the length of the initial segment of string s1 
which consists entirely of characters from (not from) string s2. 


The strtok routine considers the string s1 to consist of a sequence of zero or 
more text tokens separated by spans of one or more characters from the 
separator string s2. The first call (with pointer s1 specified) returns a pointer to 
the first character of the first token, and will have written a null character into 
sl immediately following the returned token. The function keeps track of its 


STRING (3C) STRING(3C) 


position in the string between separate calls, so that subsequent calls (which 
must be made with the first argument a NULL pointer) work through the string 
sl immediately following that token. This way, subsequent calls work through 
the string s1 until no tokens remain. The separator string s2 may be different 
from call to call. When no token remains in s1, a NULL pointer is returned. 


For user convenience, all these functions are declared in the optional 
<string.h> header file. 


SEE ALSO 
malloc(3C), malloc(3X). 


CAVEATS 
The strcmp and strncmp routines use native character comparison. Characters 
are 8-bit signed values; all ASCII characters have values of at least 0; non-ASCII 
are negative. On some machines, all characters are positive. Thus, programs 
that only compare ASCII values are portable; programs that compare ASCII with 
non-ASCII values are not. 


Character movement is performed differently in different implementations. 
Thus, overlapping moves may yield surprises. 
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NAME 


strtod, atof - convert string to double-precision number 


SYNOPSIS 


double strtod (str, ptr) 
char *str, **ptr; 


double atof (str) 
char *str; 


DESCRIPTION 


The strtod routine returns as a double-precision floating-point number the value 
represented by the character string pointed to by str. The string is scanned up 
to the first unrecognized character. 


The strtod routine recognizes an optional string of ‘‘white-space’’ characters 
[as detined by isspace in ctype(3C)], then an optional sign, then a string of 
digits optionally containing a decimal point, then an optional e or E followed 
by an optional sign or space, followed by an integer. 


If the value of ptr is not (char **)NULL, a pointer to the character terminating 
the scan is returned in the location pointed to by ptr. If no number can be 
formed, *ptr is set to str, and zero is returned. 


The atof(str) variable is equivalent to strtod(str, (char **)NULL). 


SEE ALSO 


ctype(3C), scanf(3S), strtol(3C). 


DIAGNOSTICS 


If the correct value would cause overflow, +HUGE (as defined in <math.h>) is 
returned (according to the sign of the value), and errno is set to ERANGE. 


if the correct value wouid cause underflow, zero is returned and errno is set to 
ERANGE. 
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NAME 
strtol, atol, atoi - convert string to integer 


SYNOPSIS 
long strtol (str, ptr, base) 
char *str, **ptr; 
int base; 


jong atol (str) 
char *str; 


int atoi (str) 
char *str; 


DESCRIPTION 
The strtol routine returns as a long integer the value represented by the 
Character string pointed to by str. The string is scanned up to the first character 
inconsistent with the base. Leading ‘‘white-space’’ characters [as defined by 
isspace in ctype (3C)] are ignored. 


If the value of ptr is not (char **)NULL, a pointer to the character terminating 
the scan is returned in the location pointed to by pir. If no integer can be 
formed, that location is set to str, and zero is returned. 


If base is positive (and not greater than 36), it is used as the base for 
conversion. After an optional leading sign, leading zeros are ignored, and Ox or 
OX is ignored if base is 16. 


If base is zero, the string itself determines the base: After an optional leading 
sign a leading zero indicates octal conversion, and a leading Ox or OX 
hexadecimal conversion. Otherwise, decimal conversion is used. 


Truncation from long to int can, of course, take place upon assignment or by an 
explicit cast. 


The atol(str) variable is equivalent to strtol(str, (char **)NULL, 10). 
The atoi(str) variable is equivalent to (int) strtol(str, (char **)NULL, 10). 


SEE ALSO 
ctype(3C), scanf(3S), strtod(3C). 


CAVEAT 
Overflow conditions are ignored. 
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NAME 
swab - swap bytes 


SYNOPSIS 
void swab (from, to, nbytes) 
char *from, *to; 
int nbytes; 


DESCRIPTION 
The swab routine copies nbytes bytes pointed to by from to the array pointed to 
by to, exchanging adjacent even and odd bytes. The nbytes argument should be 
even and non-negative. If nbytes is odd and positive swab uses nbytes-1 
instead. If nbytes is negative, swab does nothing. 
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NAME 
system - issue a shell command 


SYNOPSIS 
#include <stdio.h> 


int system (string) 
char *string; 


DESCRIPTION 
The system routine causes the string to be given to sh(1) as input, as if the 
string had been typed as a command at a terminal. The current process waits 
until the shell has completed, then returns the exit status of the shell. 


FILES 
/bin/sh 
SEE ALSO 
sh(1), exec(2). 
DIAGNOSTICS 
system forks to create a child process that in tum exec’s /bin/sh in order to 


execute string. If the fork or exec fails, system returns a negative value and sets 
errno. 


ce 
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NAME 
t_accept - accept a connect request 


SYNOPSIS 
#include <tiuser.h> 


int t_accept(fd, resfd, call) 
int fd; 

int resfd; 

struct t_ call *call; 


DESCRIPTION 
This function is issued by a transport user to accept a connect request. fd 
identifies the local transport endpoint where the connect indication arrived, 
resfd specifies the local transport endpoint where the connection is to be 
established. and call contains information required by the transport provider to 
complete the connection. The ¢ call structure pointed to by call contains the 
following members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


The netbuf structure is described in intro(3). In call, addr is the address of the 
caller, opt indicates any protocol-specific parameters associated with the 
connection, udata points to any user data to be returned to the caller, and 
sequence is the value returned by ¢ listen that uniquely associates the response 
with a previously received connect indication. 


A transport user can accept a connection on either the same, or on a different, 
local transport endpoint than the one on which the connect indication arrived. 
If the same endpoint is specified (resfd=fd), the connection can be accepted 
unless the following condition is true: the user has received other indications 
on that endpoint but has not responded to them (with t_accept or t_snddis). For 
this condition, ¢ accept fails and sets t_ errno to TBADF. 


If a different transport endpoint is specified (resfd!=fd), the endpoint must be 
bound to a protocol address and must be in the T_IDLE state [see 
t_getstate(3N)] before the t accept is issued. 


For both types of endpoints, ¢ accept fails and sets t errno to TLOOK if there 
are indications (such as a connect or disconnect) waiting to be received on that 
endpoint. 
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The values of parameters specified by opt and the syntax of those values are 
protocol specific. The udata argument enables the called transport user to send 
user data to the caller and the amount of user data must not exceed the limits 
supported by the transport provider as returned by t open or t getinfo. If the 
len [see netbuf in intro(3)] field of udata is zero, no data is sent to the caller. 


On failure, ¢ errno can be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint, or the user is illegally accepting a connection 
on the same transport endpoint on which the connect 
indication arrived. 


[TOUTSTATE] The function was issued in the wrong sequence on the 
transport endpoint referenced by fd, or the transport 
endpoint referred to by resfd is not in the T_IDLE state. 


[TACCES] The user does not have permission to accept a 
connection on the responding transport endpoint or use 
the specified options. 

[TBADOPT} The specified options were in an incorrect format or 
contained illegal information. 

[TBADDATA] The amount of user data specified was not within the 
bounds allowed by the transport provider. 

[TBADSEQ] An invalid sequence number was specified. 

[TLOOK] An asynchronous event has occurred on the transport 
endpoint referenced by fd and requires immediate 
attention. 

[TNOTSUPPORT} This function is not supported by the underlying 
transport provider. 

[TSYSERR] A system error has occurred during execution of this 
function. 

SEE ALSO 


intro(3), t_connect(3N), _—‘t_getstate(3N), = t_listen(3N), — t_open(3N), 
t_rcvconnect(3N). 
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DIAGNOSTICS 
Upon successful completion, a value of 0 is returned; otherwise, a value of -1 is 
returned and ¢ errno is set to indicate the error. 
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NAME 
t_alloc - allocate a library structure 


SYNOPSIS 
#include <tiuser.h> 


char *t_alloc(fd, struct_type, fields) 
int fd; 

int struct_type; 

int fields; 


DESCRIPTION 
The ¢_alloc function dynamically allocates memory for the various transport 
function argument structures as specified below. This function will allocate 
memory for the specified structure, and will also allocate memory for buffers 


referenced by the structure. 
The structure to allocate is specified by struct_type and can be one of the 
following: 

T_BIND struct t_bind 

T_CALL struct t_call 

T_OPTMGMT Struct t_optmgmt 

T_DIS struct t_discon 

T_UNITDATA struct t_unitdata 

T_UDERROR Struct t_uderr 

T_INFO struct t_info 


where each structure can be used subsequently as an argument to one or more 
iransport functions. 


Each of the above structures except T_INFO contains at least one field of type 
struct netbuf. netbuf is described in intro(3). For each field of this type, the 
user can specify that the buffer for that field should be allocated as well. The 
fields argument specifies this option, where the argument is the bitwise-OR of 
any of the following: 


T_ADDR The addr field of the ¢ bind, t call, t_unitdata, or t_uderr 
structures. 

T_OPT The opt field of the t_optmgmt, t_call, t_unitdata, or t_uderr 
structures. 
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T_UDATA The udata field of the ¢ call, t discon, or t_unitdata 
structures. 
T_ALL All relevant fields of the given structure. 


For each field specified in fields, t alloc will allocate memory for the buffer 
associated with the field and initialize the buf pointer and maxlen [see netbuf in 
intro(3) for description of buf and maxlen] field accordingly. The length of the 
buffer allocated will be based on the same size information that is returned to 
the user on t open and t getinfo. Thus, fd must refer to the transport endpoint 
through which the newly allocated structure will be passed, so that the 
appropriate size information can be accessed. If the size value associated with 
any specified field is -1 or -2 (see t open or t_getinfo), t alloc will be unable to 
determine the size of the buffer to allocate and will fail, setting ¢ errno to 
TSYSERR and errno to EINVAL. For any field not specified in fields , buf will be 
set tO NULL and maxien will be set to zero. 

Use of t alloc to allocate structures will help ensure the compatibility of user 
programs with future releases of the transport interface. 


On failure, t_ errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 


intro(3), t_free(3N), t_getinfo(3N), t_open(3N). 
CTIX Network Programmer’ s Primer. 
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DIAGNOSTICS 
On successful completion, ¢ alloc returns a pointer to the newly allocated 
structure. On failure, NULL is returned. 
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NAME 
t_bind - bind an address to a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 


int t_bind(fd, req, ret) 
int fd; 

struct t_bind *req; 
Struct t_bind *ret; 


DESCRIPTION 
This function associates a protocol address with the transport endpoint specified 
by fd and activates that transport endpoint. In connection mode, the transport 
provider may begin accepting or requesting connections on the transport 


endpoint. In connectionless mode, the transport user may send or reccive data 


units through the transport endpoint. 


The req and ret arguments point to a ¢_bind structure containing the following 
members: 


struct netbuf addr; 
unsigned qlen; 


netbuf is described in intro(3). The addr field of the t_bind structure specifies a 
protocol address and the glen field indicates the maximum number of 
outstanding connect indications. 


req requests that an address, represented by the netbuf structure, be bound to the 
given transport endpoint. Jen [see netbuf in intro(3); also for buf and maxlen] 
specifies the number of bytes in the address and buf points to the address buffer. 
maxlen has no meaning for the reg argument. On return, ret contains the 
address that the transport provider actually bound to the transport endpoint; this 
may be different from the address specified by the user in req. In ret, the user 
specifies maxlen, which is the maximum size of the address buffer and buf, 
which points to the buffer where the address is to be placed. On return, len 
specifies the number of bytes in the bound address and buf points to the bound 
address. If maxlen is not large enough to hold the returned address, an error 
will result. 


If the requested address is not available, or if no address is specified in req (the 
len field of addr in req is zero), the transport provider will assign an appropriate 
address to be bound and will return that address in the addr field of ret. The 
user can compare the addresses in reg and ret to determine whether the 
transport provider bound the transport endpoint to a different address than that 
requested. 
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req may be NULL if the user does not want to specify an address to be bound. 
Here, the value of glen is assumed to be zero, and the transport provider must 
assign an address to the transport endpoint. Similarly, ret may be NULL if the 
user does not care what address was bound by the provider and is not interested 
in the negotiated value of glen. It is valid to set req and ret to NULL for the 
same call, in which case the provider chooses the address to bind to the 
transport endpoint and does not return that information to the user. 


The glen field has meaning only when initializing a connection-mode service. 
It specifies the number of outstanding connect indications the transport provider 
should support for the given transport endpoint. An outstanding connect 
indication is one that has been passed to the transport user by the transport 
provider. A value of glen greater than zero is only meaningful when issued by a 
passive transport user who expects other users to call it. The value of glen will 
be negotiaicd by ihe transport provider and can be changed if ihe transpori 
provider cannot support the specified number of outstanding connect 
indications. On return, the glen field in ret will contain the negotiated value. 


This function allows more than one transport endpoint to be bound to the same 
protocol address (however, the transport provider must support this capability 
also), but it is not allowable to bind more than one protocol address to the same 
transport endpoint. If a user binds more than one transport endpoint to the same 
protocol address, only one endpoint can be used to listen for connect indications 
associated with that protocol address. In other words, only one ¢ bind for a 
given protocol address may specify a value of glen greater than zero. In this 
way, the transport provider can identify which transport endpoint should be 
notified of an incoming connect indication. 


If a user attempts to bind a protocol address to a second transport endpoint with 
a value of glen greater than zero, the transport provider will assign another 
address to be bound to that endpoint. If a user accepts a connection on the 
transport endpoint that is being used as the listening endpoint, the bound 
protocol address will be found to be busy for the duration of that connection. 
No other transport endpoints may be bound for listening while that initial 
listening endpoint is in the data transfer phase. This will prevent more than one 
transport endpoint bound to the same protocol address from accepting connect 
indications. 


On failure, t_ errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TOUTSTATE] The function was issued in the wrong sequence. 
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(TBADADDR] 


[TNOADDR] 
([TACCES] 


[TBUFOVFLW] 


[TS YSERR] 


SEE ALSO 
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The specified protocol address was in an incorrect 
format or contained illegal information. 


The transport provider could not allocate an address. 


The user does not have permission to use the specified 
address. 


The number of bytes allowed for an incoming argument 
is not sufficient to store the value of that argument. The 
provider’s state will change to T_IDLE and the 
information to be returned in ret will be discarded. 


A system error has occurred during execution of this 
function. 


intro(3), t_open(3N), t_optmgmt(3N), t_unbind(3N). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 


t bind returns O on success and -1 on failure and ¢ errno is set to indicate the 


error. 
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NAME 
t_close - close a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 


int t_close(fd) 
int fd; 

DESCRIPTION 
The ¢ close function informs the transport provider that the user is finished with 
the transport endpoint specified by fd and frees any local library resources 
associated with the endpoint. In addition, ¢ close closes the file associated with 
the transport endpoint. 


t close should be called from the T_UNBND state [see ¢ getstate (3N)]. 
However, this function does not check state information, so it may be called 
from any state to close a transport endpoint. If this occurs, the local library 
resources associated with the endpoint will be freed automatically. In addition, 
close(2) will be issued for that file descriptor; the close will be abortive if no 
other process has that file open and will break any transport connection that 
may be associated with that endpoint. 


On failure, t errno may be set to the following: 
[TBADF}] The specified file descriptor does not refer to a transport 
endpoint. 


SEE ALSO 
t_getstate(3N), t_open(3N), t_unbind(3N). 
UNIX System V Release 3.2 Network Programmer s Guide. 


DIAGNOSTICS 
t_ close returns 0 on success and -1 on failure and ¢ errno is set to indicate the 
error. 
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NAME 
t_connect - establish a connection with another transport user 


SYNOPSIS 
#include <tiuser.h> 


int t_connect(fd, sndcall, revcall) 
int fd; 

Struct t_call *sndcall; 

struct t_call *revcall; 


DESCRIPTION 
This function enables a transport user to request a connection to the specified 
destination transport user. fd identifies the local transport endpoint where 
communication will be established, while sndcall and rcvcall point to a t call 
structure which contains the following members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


sndcall specifies information needed by the transport provider to establish a 
connection and rcvcall specifies information that is associated with the newly 
established connection. 


netbuf is described in intro(3). In sndcall, addr specifies the protocol address of 
the destination transport user, opt presents any protocol-specific information 
that might be needed by the transport provider, udata points to optional user 
data that may be passed to the destination transport user during connection 
establishment, and sequence has no meaning for this function. 


On return in rcvcall, addr returns the protocol address associated with the 
responding transport endpoint, opt presents any protocol-specific information 
associated with the connection, udata points to optional user data that may be 
returned by the destination transport user during connection establishment, and 
sequence has no meaning for this function. 


The opt argument implies no structure on the options that may be passed to the 
transport provider. The transport provider is free to specify the structure of any 
options passed to it. These options are specific to the underlying protocol of the 
transport provider. The user can choose not to negotiate protocol options by 
setting the /en field of opt to zero. In this case, the provider may use default 
options. 
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The udata argument enables the caller to pass user data to the destination 
transport user and receive user data from the destination user during connection 
establishment. However, the amount of user data must not exceed the limits 
supported by the transport provider as returned by ¢ open (3N) ort _getinfo (3N). 
If the len [see netbuf in intro(3)] field of udata 1s zero in sndcall, no data will be 
sent to the destination transport user. 


On return, the addr, opt, and udata fields of rcvcall will be updated to reflect 
values associated with the connection. Thus, the maxlen (see netbuf in intro(3)| 
field of each argument must be set before issuing this function to indicate the 
maximum size of the buffer for each. However, rcvcall may be NULL, in which 
case no information is given to the user on return from ¢_ connect. 


By default, ¢ connect executes in synchronous mode and will wait for the 
destination user’s response before returning control to the local user. A 
successful return (that is, return value of zero) indicates that the requested 
connection has been established. However, if O_NDELAY is set (via t open or 
fenil), t_connect executes in asynchronous mode. In this case, the call will not 
wait for the remote user’s response, but it will return control immediately to the 
local user and return -1 with ¢ errno set to TNODATA to indicate that the 
connection has not yet been established. In this way, the function simply 
initiates the connection establishment procedure by sending a connect request 
to the destination transport user. 


On failure, ¢_ errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TOUTSTATE] The function was issued in the wrong sequence. 

[TNODATA] O_NDELAY was set, so the function successfully 


initiated the connection establishment procedure but did 
not wait for a response from the remote user. 


[TBADADDR] The specified protocol address was in an incorrect 
format or contained illegal information. 


[TBADOPT] The specified protocol options were in an incorrect 
format or contained illegal information. 

([TBADDATA] The amount of user data specified was not within the 
bounds allowed by the transport provider. 

[TACCES] The user does not have permission to use the specified 


address or options. 
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[TBUFOVFLW] The number of bytes allocated for an incoming 
argument is not sufficient to store the value of that 
argument. If executed in synchronous mode, the 
provider’s state, as seen by the user, changes to 
T_DATAXFER, and the connect indication information 
to be returned in rcvcall is discarded. 


[TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 


[TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 


([TSYSERR] A system error has occurred during execution of this 
function. 


emm aram 
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intro(3), t_accept(3N), t_getinfo(3N), t_listen(3N), t_open(3N), 
t_optmgmt(3N), t_rcvconnect(3N). 
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DIAGNOSTICS 
t connect returns O on success and -1 on failure and t errno is set to indicate 
the error. 
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NAME 
t_error - produce error message 


SYNOPSIS 
#include <tiuser.h> 


void t_error(errmsg) 
char *errmsg; 

extern int t_errno; 
extern char *t_errlist[]; 
extern int t_nerr; 


DESCRIPTION 

The ¢ error routine produces a message on the standard error output which 
describes the last error encountered during a call to a transport function. The 
argument string errmsg is a user-supplied error message that gives context {c 
the error. The ¢ error routine prints the user-supplied error message followed 
by a colon and the standard transport function error message for the current 
value contained in ¢ errno. If t_errno is TSYSERR, ¢ error also prints the 
standard error message for the current value contained in errno [see intro(2)]. 
The ¢_errlist array of message strings allows user message formatting; ¢_errno 
can be used as an index into this array to retrieve the error message string 
(without a terminating newline). ¢ nerr is the maximum index value for the 
t_errlist array. 


t_ errno is set when an error occurs and is not cleared on subsequent successful 
calls, 


EXAMPLE 
If a ¢ connect function fails on transport endpoint fa2 because a bad address 
was given, the following call might follow the failure: 


t_error (“t_connect failed on fd2"); 
The diagnostic message would print as: 
t_connect failed on fd2: Incorrect transport address format 


where ‘‘t_connect failed on fd2’’ tells the user which function failed on which 
transport endpoint, and ‘‘Incorrect transport address format’’ identifies the 
specific error that occurred. 


SEE ALSO 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 
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NAME 
t_free - free a library structure 


SYNOPSIS 
#include <tiuser.h> 


int ¢ free(ptr, struct_type) 
char *ptr; 
int struct_type; 


DESCRIPTION 
The ¢ free function frees memory previously allocated by ¢ alloc. This 
function will free memory for the specified structure, and will also free memory 
for buffers referenced by the structure. 


ptr points to one of the six structure types described for ¢ alloc, and struct_type 


atl_a — 


identifies tie type of that siruciure which can be one of the following: 


T_BIND struct t_bind 

T_CALL struct t_call 

T_OPTMGMT struct t_optmgmt 

T_DIS Struct t_discon 

T_UNITDATA struct t_unitdata 

T_UDERROR struct t_uderr 

T_INFO struct t_info 

where each of these structures is an argument to one or more transport 
functions. 


t free will check the addr, opt, and udata fields of the given structure (as 
appropriate) and free the buffers pointed to by the buf field of the netbuf 
structure [see intro(3)]. buf is NULL, t free will not attempt to free memory. 
After all buffers are freed, t free will free the memory associated with the 
structure pointed to by pir. 


Undefined results will occur if ptr or any of the buf pointers points to a block of 
memory that was not previously allocated by ¢ alloc. 


On failure, t errno may be set to the following: 


[TSYSERR] A system error has occurred during execution of this 
function. 
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SEE ALSO 
intro(3), t_alloc(3N). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer s Guide. 


DIAGNOSTICS 
t free returns 0 on success and -1 on failure and ¢ errno is set to indicate the 
error. 
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NAME 
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t_getinfo - get protocol-specific service information 


SYNOPSIS 


#include <tiuser.h> 
int t_getinfo(fd, info) 


int fd; 


struct t_info *info; 


DESCRIPTION 


This function returns the current characteristics of the underlying transport 
protocol associated with file descriptor fd. The info structure returns the same 
information returned by ¢ open. This function enables a transport user to 


access this information during any phase of communication. 
This argument points to a ¢ info structure which contains the following 
members: 
long addr; /* max size of the transport protocol address */ 
long options; /* max number of bytes of protocol-specific options */ 
long tsdu; /* max size of a transport service data unit (TSDU) */ 
long etsdu; /* max size of an expedited transport service data unit (ETSDU) */ 
long connect; /* max amount of data allowed on connection establishment */ 
/* functions */ 
long discon; /* max amount of data allowed on t_snddis and t_rcvdis */ 


/* functions */ 


long servtype; /* service type supported by the transport provider */ 


The values of the fields have the following meanings: 


addr 


options 


tsdu 


A value greater than or equal to zero indicates the maximum size of 
a transport protocol address; a value of -1 specifies that there is no 
limit on the address size; and a value of -2 specifies that the 
transport provider does not provide user access to transport protocol 
addresses. 


A value greater than or equal to zero indicates the maximum number 
of bytes of protocol-specific options supported by the provider; a 
value of -1 specifies that there is no limit on the option size; and a 
value of -2 specifies that the transport provider does not support 
user-settable options. 


A value greater than zero specifies the maximum size of a transport 
service data unit (TSDU); a value of zero specifies that the transport 
provider does not support the concept of TSDU, although it does 
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etsdu 


connect 


discon 


servtype 
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support the sending of a data stream with no logical boundaries 
preserved across a connection; a value of -1 specifies that there is no 
limit on the size of a TSDU; and a value of -2 specifies that the 
transfer of normal data is not supported by the transport provider. 


A value greater than zero specifies the maximum size of an 
expedited transport service data unit (ETSDU); a value of zero 
specifies that the transport provider does not support the concept of 
ETSDU, although it does support the sending of an expedited data 
stream with no logical boundaries preserved across a connection; a 
value of -1 specifies that there is no limit on the size of an ETSDU; 
and a value of -2 specifies that the transfer of expedited data is not 
supported by the transport provider. 


A value greater than or equal to zero specifies the maximum amount 
of data that can be associated with connection establishment 
functions; a value of -1 specifies that there 1s no limit on the amount 
of data sent during connection establishment; and a value of -2 
specifies that the transport provider does not allow data to be sent 
with connection establishment functions. 


A value greater than or equal to zero specifies the maximum amount 
of data that can be associated with the ¢ smddis and ¢ _rcvdis 
functions; a value of -1 specifies that there is no limit on the amount 
of data sent with these abortive release functions; and a value of -2 
specifies that the transport provider does not allow data to be sent 
with the abortive release functions. 


This field specifies the service type supported by the transport 
provider, as described below. 


If a transport user is concerned with protocol independence, the above sizes can 
be accessed to determine how large the buffers must be to hold each piece of 
information. Alternatively, the ¢ alloc function can be used to allocate these 
buffers. An error will result if a transport user exceeds the allowed data size on 
any function. The value of each field may change as a result of option 
negotiation, and ¢ getinfo enables a user to retrieve the current characteristics. 


The servtype field of info may specify one of the following values on return: 


T_COTS The transport provider supports a connection-mode service 
but does not support the optional orderly release facility. 
T_COTS_ORD The transport provider supports a connection-mode service 


with the optional orderly release facility. 


T_GETINFO(3N) (Networking Support Utilities) T_GETINFO(3N) 


T_CLTS The transport provider supports a connectionless-mode 
service. For this service type, ¢ open will return -2 for 
etsdu, connect, and discon. 


On failure, f errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
t_open(3N). 


CTIX Network Programmer's Primer. 
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DIAGNOSTICS 
t_getinfo returns 0 on success and -1 on failure and ¢ errno is set to indicate the 
error. 
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NAME 
t_getstate - get the current state 


SYNOPSIS 
#include <tiuser.h> 


int t_getstate(fd) 
int fd; 


DESCRIPTION 
The ¢ _getstate function returns the current state of the provider associated with 
the transport endpoint specified by fd. 


On failure, ¢_errno can be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TSTATECHNG] The transport provider is undergoing a state change. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
t_open(3N). 


CTIX Network Programmer’ s Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 
t getstate returns the current state on successful completion, -1 on failure; 
t errno is set to indicate the error. The current state can be one of the 


following: 

T_UNBND unbound 

T_IDLE idle 

T_OUTCON outgoing connection pending 

T_INCON incoming connection pending 

T_DATAXFER data transfer 

T_OUTREL outgoing orderly release (waiting for an orderly release 
indication) 

T_INREL incoming orderly release (waiting for an orderly release 
request) 


If the provider is undergoing a state transition when ¢ getstate is called, the 
function will fail. 


T_LISTEN(3N) (Networking Support Utilities) T_LISTEN(3N) 


NAME 
t_listen - listen for a connect request 


SYNOPSIS 
#include <tiuser.h> 


int t_listen(fd, call) 
int fd; 
Struct t_call *call; 


DESCRIPTION 
This function listens for a connect request from a calling transport user. fd 
identifies the local transport endpoint where connect indications arrive, and on 
return, call contains information describing the connect indication. call points 
to a t_cail structure which contains the following members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


netbuf is described in intro(3). In call, addr returns the protocol address of the 
calling transport user, opt returns protocol-specific parameters associated with 
the connect request, udata returns any user data sent by the caller on the 
connect request, and sequence is a number that uniquely identifies the returned 
connect indication. The value of sequence enables the user to listen for 
multiple connect indications before responding to any of them. 


Since this function returns values for the addr, opt, and udata fields of call, the 
maxlen [see netbuf in intro(3)] field of each must be set before issuing the 
{ listen to indicate the maximum size of the buffer for each. 


By default, t listen executes in synchronous mode and waits for a connect 
indication to arrive before returning to the user. However, if O_NDELAY is set 
(via t open or fentl), t listen executes asynchronously, reducing to a poll for 
existing connect indications. If none are available, it returns -1 and sets t errno 
to TNODATA. 


On failure, ¢_ errno can be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a 
transport endpoint. 
(TBUFOVFLW] The number of bytes allocated for an incoming 


argument is not sufficient to store the value of that 
argument. The provider’s state, as seen by the user, 


e 
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changes to T_INCON, and the connect indication 
information to be returned in call is discarded. 


[TNODATA]} O_NDELAY was set, but no connect indications had 
been queued. 

[TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 

[TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 

[TSYSERR] A system error has occurred during execution of this 
function. 

CAVEATS 


If a user issues ¢ listen in synchronous mode on a transport endpoint that was 
not bound for listening (that is, glen was zero on t bind), the call will wait 
forever because no connect indications will arrive on that endpoint. 


SEE ALSO 
intro(3), t_accept(3N), t_bind(3N), t_connect(3N), t_open(3N), 
t_rcvconnect(3N). 
CTIX Network Programmer’ s Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 
t listen returns 0 on success and -1 on failure and ¢ errno is set to indicate the 
error. 
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NAME 
t_look - look at the current event on a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 


int t_look(fd) 
int fd; 


DESCRIPTION 

This function returns the current event on the transport endpoint specified by fd. 
This function enables a transport provider to notify a transport user of an 
asynchronous event when the user is issuing functions in synchronous mode. 
Certain events require immediate notification of the user and are indicated by a 
specific error, TLOOK, on the current or next function to be executed. 

This function also enabies a wansport user to poll a transport endpoint 
periodically for asynchronous events. 


On failure, t_errno can be set to one of the following: 


([TBADF] The specified file descriptor does not refer to a transport 
endpoint. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
t_open(3N). 


CTIX Network Programmer's Primer. 
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DIAGNOSTICS 
Upon success, ¢ fook returns a value that indicates which of the allowable 
events has occurred, or returns zero if no event exists. One of the following 
events is returned: 


T_LISTEN connection indication received 
T_CONNECT connect confirmation received 
T_DATA normal data received 
T_EXDATA expedited data received 
T_DISCONNECT disconnect received 

T_ERROR fatal error indication 
T_UDERR datagram error indication 
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T_ORDREL orderly release indication 


On failure, -1 is returned and ¢ errno is set to indicate the error. 
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NAME 
t_open - establish a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 


int t_open(path, oflag, info) 
char *path; 

int oflag; 

struct t_info *info; 


DESCRIPTION 
The ¢ open function must be called as the first step in the initialization of a 
transport endpoint. This function establishes a transport endpoint by opening a 
UNIX file that identifies a particular transport provider (that is, transport 
protocol) and returning a file descripior that identifies ihat endpoini. For 
example, opening the file /dev/iso_cots identifies an OSI connection-oriented 
transport layer protocol as the transport provider. 


path points to the path name of the file to open, and oflag identifies any open 
flags [as in open(2)]. t open returns a file descriptor that will be used by all 
subsequent functions to identify the particular local transport endpoint. 


This function also returns various default characteristics of the underlying 
transport protocol by setting fields in the t info structure. This argument points 
to a ¢ info which contains the following members: 


long addr; /* max size of the transport protocol address */ 
long options; /* max number of bytes of protocol-specific options */ 
long tsdu; /* max size of a transport service data unit (TSDU) */ 
long etsdu; /* max size of an expedited transport service data unit */ 
f* (ETSDU) */ 
long connect; /* max amount of data allowed on connection */ 
| /* establishment functions */ 


long discon; / max amount of data allowed on t_snddis and t_revdis */ 
*/ functions */ 
long servtype; /* service type supported by the transport provider */ 


The values of the fields have the following meanings: 


addr A value greater than or equal to zero indicates the maximum size of 
a transport protocol address; a value of -1 specifies that there is no 
limit on the address size; and a value of -2 specifies that the 
transport provider does not provide user access to transport protocol 
addresses. 
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options 
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connect 


discon 
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A value greater than or equal to zero indicates the maximum number 
of bytes of protocol-specific options supported by the provider; a 
value of -1 specifies that there is no limit on the option size; and a 
value of -2 specifies that the transport provider does not support 
user-settable options. 


A value greater than zero specifies the maximum size of a transport 
service data unit (TSDU); a value of zero specifies that the transport 
provider does not support the concept of TSDU, although it does 
support the sending of a data stream with no logical boundaries 
preserved across a connection; a value of -1 specifies that there is no 
limit on the size of a TSDU; and a value of -2 specifies that the 
transfer of normal data is not supported by the transport provider. 


A value greater than zero specifies the maximum size of an 
expedited transport service data unit (ETSDU); a value of zero 
specifies that the transport provider does not support the concept of 
ETSDU, although it does support the sending of an expedited data 
Stream with no logical boundaries preserved across a connection; a 
value of -1 specifies that there is no limit on the size of an ETSDU; 
and a value of -2 specifies that the transfer of expedited data is not 
supported by the transport provider. 


A value greater than or equal to zero specifies the maximum amount 
of data that can be associated with connection establishment 
functions; a value of -1 specifies that there is no limit on the amount 
of data sent during connection establishment; and a value of -2 
specifies that the transport provider does not allow data to be sent 
with connection establishment functions. 


A value greater than or equal to zero specifies the maximum amount 
of data that can be associated with the ¢ snddis and ¢ rcvdis 
functions; a value of -1 specifies that there is no limit on the amount 
of data sent with these abortive release functions; and a value of -2 
specifies that the transport provider does not allow data to be sent 
with the abortive release functions. 


This field specifies the service type supported by the transport 
provider, as described below. 


If a transport user is concerned with protocol independence, the above sizes can 
be accessed to determine how large the buffers must be to hold each piece of 
information. Alternatively, the ¢ alloc function can be used to allocate these 
buffers. An error will result if a transport user exceeds the allowed data size on 
any function. 
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The servtype field of info can specify one of the following values on return: 


T_COTS The transport provider supports a connection-mode service 
but does not support the optional orderly release facility. 


T_COTS_ORD The transport provider supports a connection-mode service 
with the optional orderly release facility. 


T_CLTS The transport provider supports a connectionless-mode 
service. For this service type, t_open will return -2 for 
etsdu, connect, and discon. 


A single transport endpoint can support only one of the above services at one 
time. 


If info is set to NULL by the transport user, no protocol information is returned 
by ¢_ open. 


On failure, ¢_errno may be set to the following: 


[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
open(2). 
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DIAGNOSTICS 
t open returns a valid file descriptor on success and -1 on failure and t errno is 
set to indicate the error. 


T_OPTMGMT(3N) (Networking Support Util.) T_OPTMGMT(3N) 


NAME 
t_optmgmt - manage options for a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 


int t optmgmt(fd, req, ret) 
int fd; 

struct t_optmgmt *req; 
struct t optmgmt *ret; 


DESCRIPTION 
The ¢_ optmgmt function enables a transport user to retrieve, verify, or negotiate 
protocol options with the transport provider. fd identifies a bound transport 
endpoint. 


The req and ret arguments point to a t optmgmt structure containing the 
following members: 


struct netbuf opt; 
long flags; 


The opt field identifies protocol options and the flags field specifies the action 
to take with those options. 


The options are represented by a netbuf [see intro(3); also for len, buf and 
maxlen] structure in a manner similar to the address in t bind. reg requests a 
specific action of the provider and to send options to the provider. len specifies 
the number of bytes in the options, buf points to the options buffer, and maxlen 
has no meaning for the req argument. The transport provider may return 
options and flag values to the user through ret. For ret, maxlen specifies the 
maximum size of the options buffer and buf points to the buffer where the 
options are to be placed. On return, len specifies the number of bytes of options 
returned. maxlen has no meaning for the reg argument, but must be set in the 
ret argument to specify the maximum number of bytes the options buffer can 
hold. The actual structure and content of the options are imposed by the 
transport provider. 


The flags field of req can specify one of the following actions: 


T_NEGOTIATE This action enables the user to negotiate the values of the 
options specified in req with the transport provider. The 
provider will evaluate the requested options and negotiate 
the values, returning the negotiated values through ret. 


T_CHECK This action enables the user to verify whether or not the 
options specified in req are supported by the transport 


a 
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provider. On return, the flags field of ret will have either 
T_SUCCESS or T_FAILURE set to indicate to the user 
whether or not the options are supported. These flags are 
only meaningful for the T.CHECK request. 


This action enables a user to retrieve the default options 
supported by the transport provider into the opt field of 
ret. In req, the len field of opt must be zero and the buf 
field may be NULL. 


If issued as part of the connectionless-mode service, t optmgmt may block due 
to flow control constraints. The function will not complete until the transport 
provider has processed all previously sent data units. 


On failure, ¢ errno can be set to one of the following: 


[TBADF] 


[TOUTSTATE] 
[TACCES] 


(TBADOPT] 


[TBADFLAG] 


[TBUFOVFLW] 


[TSYSERR] 


SEE ALSO 


The specified file descriptor does not refer to a transport 
endpoint. 


The function was issued in the wrong sequence. 


The user does not have permission to negotiate the 
specified options. 

The specified protocol options were in an incorrect 
format or contained illegal information. 

An invalid flag was specified. 


The number of bytes allowed for an incoming argument 
is not sufficient to store the value of that argument. The 
information to be returned in ret will be discarded. 


A system error has occurred during execution of this 
function. 


intro(3), t_getinfo(3N), t_open(3N). 
CTIX Network Programmer’ s Primer. 
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DIAGNOSTICS 


The ¢ optmgmt call returns 0 on success and -1 on failure and ¢t errno is set to 


indicate the error. 
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NAME 
t_rcv - receive data or expedited data sent over a connection 


SYNOPSIS 
int t rcv(fd, buf, nbytes, flags) 
int fd; 
char *buf; 
unsigned nbytes; 
int *flags; 

DESCRIPTION 
This function receives either normal or expedited data. fd identifies the local 
transport endpoint through which data will arrive, buf points to a receive buffer 
where user data will be placed, and nbytes specifies the size of the receive 
buffer. flags may be set on return from ¢ rcv and specifies optional flags as 
described below. 


By default, t_ rcv operates in synchronous mode and will wait for data to arrive 
if none is currently available. However, if O_NDELAY is set (via t open or 
fentl), t_rcv will execute in asynchronous mode and will fail if no data is 
available. (See TNODATA below.) 


On return from the call, if T.MORE is set in flags this indicates that there is 
more data and the current transport service data unit (TSDU) or expedited 
transport service data unit (ETSDU) must be received in multiple ¢ rcv calls. 
Each ¢ rcv with the T.MORE flag set indicates that another ¢ rcv must follow 
immediately to get more data for the current TSDU. The end of the TSDU is 
identified by the return of a ¢ rcv call with the T.MORE flag not set. If the 
transport provider does not support the concept of a TSDU as indicated in the 
info argument on return from ¢ open or t getinfo, the T_MORE flag is not 
meaningful and should be ignored. 


On return, the data returned is expedited data if T.EXPEDITED is set in flags. If 
the number of bytes of expedited data exceeds nbytes, t rcv will set 
T_EXPEDITED and T_MORE on return from the initial call. Subsequent calls to 
retrieve the remaining ETSDU will not have T.EXPEDITED set on return. The 
end of the ETSDU is identified by the return of a ¢ rcv call with the T.MORE 
flag not set. 


If expedited data arrives after part of a TSDU has been retrieved, receipt of the 
remainder of the TSDU will be suspended until the ETSDU has been processed. 
Only after the full ETSDU has been retrieved (T.MORE not set) will the 
remainder of the TSDU be available to the user. 
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On failure, ¢_ errno can be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TNODATA] O_NDELAY was set, but no data is currently available 
from the transport provider. 

[TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 

[TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 

[TSYSERR] A system error has occurred during execution of this 
function. 

SEE ALSO 


t_open(3N), t_snd(3N). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 
On successful completion, ¢ rcv returns the number of bytes received, and it 
returns -1 on failure and ¢ errno is set to indicate the error. 
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NAME 


t_rcvconnect - receive the confirmation from a connect request 


SYNOPSIS 


#include <tiuser.h> 


int t_rcvconnect(fd, call) 
int fd; 
struct t_call *call; 


DESCRIPTION 


This function enables a calling transport user to determine the status of a 
previously sent connect request and is used in conjunction with t connect to 
establish a connection in asynchronous mode. The connection will be 
established on successful completion of this function. 

fd identifies the iocal ifanspori endpoint where communication will be 
established, and call contains information associated with the newly established 
connection. call points to a ¢ call structure which contains the following 
members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


netbuf is described in intro(3). In call, addr returns the protocol address 
associated with the responding transport endpoint, opt presents any protocol- 
specific information associated with the connection, udata points to optional 
user data that may be returned by the destination transport user during 
connection establishment, and sequence has no meaning for this function. 


The maxlen [see netbuf in intro(3)] field of each argument must be set before 
issuing this function to indicate the maximum size of the buffer for each. 
However, call may be NULL, in which case no information is given to the user 
on return from t rcvconnect. By default, t rcvconnect executes in synchronous 
mode and waits for the connection to be established before returning. On 
return, the addr, opt, and udata fields reflect values associated with the 
connection. 


If O_LNDELAY is set (via t open or fcntl), t_rcvconnect executes in 
asynchronous mode and reduces to a poll for existing connect confirmations. If 
none are available, t_rcvconnect fails and returns immediately without waiting 
for the connection to be established. (See TNODATA below.) t rcvconnect 
must be re-issued at a later time to complete the connection establishment phase 
and retrieve the information returned in call. 
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On failure, ¢_ errno can be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a 
transport endpoint. 
[TBUFOVFLW] The number of bytes allocated for an incoming 


argument is not sufficient to store the value of that 
argument and the connect information to be returned 
in call will be discarded. The provider’s state, as seen 
by the user, will be changed to DATAXFER. 


[TNODATA] O_NDELAY was set, but a connect confirmation has 
not yet arrived. 

[TLOOK] An asynchronous event has occurred on this transport 
connection and requires immediate attention. 

[TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 

[TSYSERR] A system error has occurred during execution of this 
function. 

SEE ALSO 


intro(3), t_accept(3N), t_bind(3N), t_connect(3N), t_listen(3N), t_open(3N). 
CTIX Network Programmer's Primer. 
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DIAGNOSTICS 
t rcvconnect returns 0 on success and -1 on failure and ¢ errno is set to indicate 
the error. 
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NAME 
t_rcvdis - retrieve information from disconnect 


SYNOPSIS 
#include <tiuser.h> 


t_rcvdis(fd, discon) 
int fd; 
struct t_discon *discon; 


DESCRIPTION 
This function identifies the cause of a disconnect and retrieves any user data 
sent with the disconnect. fd identifies the local transport endpoint where the 
connection existed, and discon points to a t discon structure containing the 
following members: 


struct netbuf udata; 
int reason; 
int sequence; 


netbuf is described in intro(3). reason specifies the reason for the disconnect 
through a protocol-dependent reason code, udata identifies any user data that 
was sent with the disconnect, and sequence can identify an outstanding connect 
indication with which the disconnect is associated. sequence is only 
meaningful when ¢ rcvdis is issued by a passive transport user who has 
executed one or more ¢ listen functions and is processing the resulting connect 
indications. If a disconnect indication occurs, sequence can be used to identify 
which of the outstanding connect indications is associated with the disconnect. 


If a user does not care if there is incoming data and does not need to know the 
value of reason or sequence , discon may be NULL and any user data associated 
with the disconnect will be discarded. However, if a user has retrieved more 
than one outstanding connect indication (via ¢ listen) and discon is NULL, the 
user will be unable to identify with which connect indication the disconnect is 
associated. 


On failure, t errno may be set to one of the following: 


(TBADF] The specified file descriptor does not refer to a 
transport endpoint. 

[TNODIS] No disconnect indication currently exists on the 
specified transport endpoint. 

[TBUFOVFLW] The number of bytes allocated for incoming data is not 


sufficient to store the data. The provider’s state, as 
seen by the user, will change to T_IDLE, and the 
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disconnect indication information to be returned in 


discon will be discarded. 

[TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 

[TSYSERR] A system error has occurred during execution of this 
function. 


SEE ALSO 
intro(3), t_connect(3N), t_listen(3N), t_open(3N), t_snddis(3N). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 
t rcvdis returns 0 on success and -1 on failure and ¢ errno is set to indicate the 
CiTOF. 
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NAME 
t_rcvrel - acknowledge receipt of an orderly release indication 


SYNOPSIS 
#include <tiuser.h> 


t_revrel(fd) 
int fd; 


DESCRIPTION 
This function acknowledges receipt of an orderly release indication. fd 
identifies the local transport endpoint where the connection exists. After 
receipt of this indication, the user cannot receive more data because such an 
attempt will block forever. However, the user can send data over the 
connection if ¢ sndrel has not been issued by the user. 


This funciion is an optional service of the transport provider and is only 
Supported if the transport provider returned service type T.COTS_ORD on 
t openort getinfo. 


On failure, ¢ errno can be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a 
transport endpoint. 

[TNOREL] No orderly release indication currently exists on the 
specified transport endpoint. 

[TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 

[TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 

[TSYSERR] A system error has occurred during execution of this 
function. 

SEE ALSO 


t_open(3N), t_sndrel(3N). 
CTIX Network Programmer’ s Primer. 
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DIAGNOSTICS 
t_rcvrel returns 0 on success and -1 on failure ¢ errno is set to indicate the 
error. 
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NAME 
t_rcvudata - receive a data unit 


SYNOPSIS 
#include <tiuser.h> 


int t_rcvudata(fd, unitdata, flags) 
int fd; 
struct t_unitdata *unitdata; 
int *flags; 

DESCRIPTION 
This function is used in connectionless mode to receive a data unit from another 
transport user. fd identifies the local transport endpoint through which data will 
be received, unitdata holds information associated with the received data unit, 
and flags is set on return to indicate that the complete data unit was not 
received. unitdata points to a ¢_unitdata structure containing the following 
members: 


struct netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 


The maxlen [see netbufin intro(3)] field of addr, opt, and udata must be set 
before issuing this function to indicate the maximum size of the buffer for each. 


On return from this call, addr specifies the protocol address of the sending user, 
opt identifies protocol-specific options that were associated with this data unit, 
and udata specifies the user data that was received. 


By default, ¢ rcvudata operates in synchronous mode and will wait for a data 
unit to arrive if none is currently available. However, if O_NDELAY is set (via 
t open or fcntl), t_ rcvudata will execute in asynchronous mode and will fail if 
no data units are available. 


If the buffer defined in the udata field of unitdata is not large enough to hold 
the current data unit, the buffer will be filled and T.MORE will be set in flags 
on return to indicate that another t_rcvudata should be issued to retrieve the rest 
of the data unit. Subsequent ¢ rcvudata call(s) will return zero for the length of 
the address and options until the full data unit has been received. 


On failure, t_errno can be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a 
transport endpoint. 
[TNODATA] O_NDELAY was set, but no data units are currently 


available from the transport provider. 
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[TBUFOVFLW] The number of bytes allocated for the incoming 
protocol address or options is not sufficient to store the 
information. The unit data information to be returned 


in unitdata will be discarded. 

[TLOOK] An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 

[TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 

[TSYSERR] A system error has occurred during execution of this 
function. 


SEE ALSO 
intro(3), t_rcvuderr(3N), t_sndudata(3N). 
CTiIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer s Guide. 
DIAGNOSTICS 
t rcvudata returns 0 on successful completion and -1 on failure and ¢ errno is 
set to indicate the error. 
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NAME 
t_rcvuderr - receive a unit data error indication 


SYNOPSIS 
#include <tiuser.h> 


int t rcvuderr(fd, uderr) 
int fd; 
struct t_uderr *uderr; 


DESCRIPTION 

This function is used in connectionless mode to receive information concerning 
an efror On a previously sent data unit and should only be issued following a 
unit data error indication. It informs the transport user that a data unit with a 
specific destination address and protocol options produced an error. fd 
identifies the local transport endpoint through which the error report will be 
received, and uderr points to a ¢ uderr structure containing the following 
members: 


struct netbuf addr; 
struct netbuf opt; 
long error; 


netbuf is described in intro(3). The maxlen [see netbuf in intro(3)] field of addr 
and opt must be set before issuing this function to indicate the maximum size of 
the buffer for each. 


On return from this call, the addr structure specifies the destination protocol 
address of the erroneous data unit, the opt structure identifies protocol-specific 
options that were associated with the data unit, and error specifies a protocol- 
dependent error code. 


If the user does not care to identify the data unit that produced an error, uderr 
may be set to NULL and ¢ rcvuderr will simply clear the error indication 
without reporting any information to the user. 


On failure, t errno may be set to one of the following: 


(TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TNOUDERR] No unit data error indication currently exists on the 
specified transport endpoint. 

[TBUFOVFLW] The number of bytes allocated for the incoming protocol 


address or options is not sufficient to store the 
information. The unit data error information to be 
returned in uderr wiil be discarded. 
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[TNOTSUPPORT] This function is not supported by the underlying transport 
provider. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 
intro(3), t_rcvudata(3N), t_sndudata(3N). 
CTIX Network Programmer's Primer. 
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DIAGNOSTICS 
t rcvuderr returns 0 on successful completion and -1 on failure and ¢ errno is 


set to indicate the error. 
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NAME 
t_snd - send data or expedited data over a connection 


SYNOPSIS 
#include <tiuser.h> 


int t_snd(fd, buf, nbytes, flags) 
int fd; 

char *buf; 

unsigned nbytes; 

int flags; 


DESCRIPTION 
This function sends either normal or expedited data. fd identifies the local 
transport endpoint over which data should be sent, buf points to the user data, 


* 


nbytes specifies the number of bytes of user data to be sent, and flags specifies 


_-— ——- 


any optional flags described below. 


By default, ¢ snd operates in synchronous mode and may wait if flow control 
restrictions prevent the data from being accepted by the local transport provider 
at the time the call is made. However, if O_NDELAY is set (via t open or fcntl), 
t_ snd will execute in asynchronous mode and will fail immediately if there are 
flow control restrictions. 


Even when there are no flow control restrictions, t_snd will wait if STREAMS 
internal resources are not available, regardless of the state of O_NDELAY. 


On successful completion, t snd returns the number of bytes accepted by the 
transport provider. Normally this will be equal to the number of bytes specified 
in nbytes. However, if O_NDELAY is set, it is possible that only part of the data 
will be accepted by the transport provider. In this case, ¢_snd will set TMORE 
for the data that was sent (see below) and will return a value less than nbytes. If 
nbytes 1s zero, no data will be passed to the provider and ¢ snd will return zero. 


If T.EXPEDITED is set in flags, the data will be sent as expedited data, and will 
be subject to the interpretations of the transport provider. 


If T.MORE is set in flags, or is set as described above, an indication is sent to 
the transport provider that the transport service data unit (TSDU) (or expedited 
transport service data unit - ETSDU) is being sent through multiple ¢ snd calls. 
Each ¢ snd with the T.MORE flag set indicates that another ¢ snd will follow 
with more data for the current TSDU. The end of the TSDU (or ETSDU) is 
identified by a ¢ snd call with the T_MORE flag not set. Use of T.MORE 
enables a user to break up large logical data units without losing the boundaries 
of those units at the other end of the connection. The flag implies nothing about 
how the data is packaged for transfer below the transport interface. If the 
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transport provider does not support the concept of a TSDU as indicated in the 
info argument on return from ¢ open or t_getinfo, the T.MORE flag is not 
meaningful and should be ignored. 


The size of each TSDU or ETSDU must not exceed the limits of the 
corresponding parameters of the transport provider as returned by ¢ open or 
t getinfo. (Note that ¢ getinfo returns the limits of several parameters, not just 
those of TSDU or ETSDU.) If the size is exceeded, a TSYSERR with system error 
EPROTO will occur. However, the ¢ snd may not fail because EPROTO errors 
may not be reported immediately. In this case, a subsequent call that accesses 
the transport endpoint will fail with the associated TSYSERR. 


If t_snd is issued from the T_IDLE state, the provider may silently discard the 
data. If ¢ snd is issued from any state other than T.DATAXFER, T_INREL or 
T_IDLE, the provider will generate a TSYSERR with system error EPROTO 
(which may be reported in the manner described above). 


On failure, t_errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a 
transport endpoint. 

(TFLOW] O_NDELAY was set, but the flow control mechanism 
prevented the transport provider from accepting data at 
this time. 

[TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 

([TSYSERR] A system error [See intro(2)] has been detected during 


execution of this function. 


SEE ALSO 
t_open(3N), t_rcv(3N). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer’ s Guide. 


DIAGNOSTICS 
On successful completion, ¢_ snd returns the number of bytes accepted by the 
transport provider, and it returns -1 on failure and ¢ errno is set to indicate the 
error. 
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NAME 
t_snddis - send user-initiated disconnect request 


SYNOPSIS 
#include <tiuser.h> 


int ¢ snddis(fd, call) 
int fd; 
struct t_call *call; 


DESCRIPTION 
This function initiates an abortive release on an already established connection 
or rejects a connect request. fd identifies the local transport endpoint of the 
connection, and call specifies information associated with the abortive release. 
call points to a ¢_call structure that contains the following members: 


struct netbuf addr: 
struct netbuf opt; 
struct netbuf udata; 
int sequence; 


netbuf is described in intro(3). The values in call have different semantics, 
depending on the context of the call to t_snddis. When rejecting a connect 
request, call must be non-NULL and contain a valid value of sequence to 
uniquely identify the rejected connect indication to the transport provider. The 
addr and opt fields of call are ignored. In all other cases, call need only be used 
when data is being sent with the disconnect request. The addr, opt, and 
sequence fields of the ¢ call structure are ignored. If the user does not want to 
send data to the remote user, the value of call may be NULL. 


udata specifies the user data to be sent to the remote user. The amount of user 
data cannot exceed the limits supported by the transport provider as returned by 
t openort getinfo. If the len field of udata is zero, no data will be sent to the 
remote user. 


On failure, t_ errno may be set to one of the following: 


[TBADF}] The specified file descriptor does not refer to a transport 
endpoint. 

[TOUTSTATE] The function was issued in the wrong sequence. The 
transport provider’s outgoing queue may be flushed, so 
data may be lost. 

[TBADDATA] The amount of user data specified was not within the 


bounds allowed by the transport provider. The transport 
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[TBADSEQ] 


[TLOOK] 


[TNOTSUPPORT] 


[TSYSERR] 


SEE ALSO 
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provider’s outgoing queue will be flushed, so data may 
be lost. 


An invalid sequence number was specified, or a NULL 
call structure was specified when rejecting a connect 
request. The transport provider’s outgoing queue will 
be flushed, so data may be lost. 


An asynchronous event has occurred on this transport 
endpoint and requires immediate attention. 

This function is not supported by the underlying 
transport provider. 


A system error has occurred during execution of this 
function. 


intro(3), t_connect(3N), t_getinfo(3N), t_listen(3N), t_open(3N). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 


t_ snddis returns 0 on success and -1 on failure and ¢ errno is set to indicate the 


error. 
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NAME 
t_sndrel - initiate an orderly release 


SYNOPSIS 
#include <tiuser.h> 


int t_sndrel(fd) 
int fd; 


DESCRIPTION 
This function initiates an orderly release of a transport connection and indicates 
to the transport provider that the transport user has no more data to send. fd 
identifies the local transport endpoint where the connection exists. After 
issuing ¢ sndrel, the user cannot send any more data over the connection. 
However, a user can continue to receive data if an orderly release indication has 
heen received, 


This function is an optional service of the transport provider and is only 
supported if the transport provider returned service type T.COTS_ORD on 
t openort getinfo. 


On failure, «_ errno may be set to one of the following: 


(TBADF] The specified file descriptor does not refer to a 
transport endpoint. 
[TFLOW} O_NDELAY was set, but the flow control mechanism 


prevented the transport provider from accepting the 
function at this time. 


(TNOTSUPPORT] This function is not supported by the underlying 
transport provider. 
([TSYSERR} A system error has occurred during execution of this 
function. 
SEE ALSO 


t_open(3N), t_revrel(3N). 
CTIX Network Programmer’ s Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 
t_sndrel returns 0 on success and -1 on failure and ft errno is set to indicate the 
error. 
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NAME 
t_sndudata - send a data unit 


SYNOPSIS 
#include <tiuser.h> 


int t_sndudata(fd, unitdata) 
int fd; 
struct t_unitdata *unitdata; 
DESCRIPTION 
This function is used in connectionless mode to send a data unit to another 
transport user. fd identifies the local transport endpoint through which data will 
be sent, and unitdata points to a ¢_unitdata structure containing the following 
members: 
siruci netbuf addr; 
struct netbuf opt; 
struct netbuf udata; 


netbuf is described in intro(3). In unitdata, addr specifies the protocol address 
of the destination user, opt identifies protocol-specific options that the user 
wants associated with this request, and udata specifies the user data to be sent. 
The user can choose not to specify what protocol options are associated with 
the transfer by setting the len field of opt to zero. In this case, the provider can 
use default options. 


If the len field of udata is zero, no data unit will be passed to the transport 
provider; ¢ sndudata will not send zero-length data units. 


By default, ¢ sndudata operates in synchronous mode and may wait if flow 
control restrictions prevent the data from being accepted by the local transport 
provider at the time the call is made. However, if O_ NDELAY is set (via ¢_ open 
or fcntl), t_sndudata will execute in asynchronous mode and will fail under 
such conditions. 


If ¢_sndudata is issued from an invalid state, or if the amount of data specified 
in udata exceeds the TSDU size as returned by ¢ open or t_getinfo , the provider 
will generate an EPROTO protocol error. (See TSYSERR below.) 


On failure, f_ errno may be set to one of the following: 


[TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TFLOW] O_NDELAY was set, but the flow control mechanism 
prevented the transport provider from accepting data at 
this time. 


T_SNDUDATA(3N) 
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[TNOTSUPPORT] This function is not supported by the underlying transport 
provider. 
[TSYSERR] A system error has occurred during execution of this 
function. 
SEE ALSO 


intro(3), t_rcvudata(3N), t_rcvuderr(3N). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer s Guide. 


DIAGNOSTICS 
t sndudata returns 0 on successful completion and -1 on failure ¢ errno is set to 


indicate the error. 
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NAME 
t_sync - synchronize transport library 


SYNOPSIS 
#include <tiuser.h> 


int t_sync(fd) 
int fd; 


DESCRIPTION 

For the transport endpoint specified by fd, t sync synchronizes the data 
Structures managed by the transport library with information from the 
underlying transport provider. In doing so, it can convert a raw file descriptor 
[obtained via open(2), dup(2), or as a result of a fork(2) and exec(2)} to an 
initialized transport endpoint, assuming that the file descriptor made a reference 
to a transport provider. This function also allows two cooperating processes to 
synchronize their interaction with a transport provider. 


For example, if a process forks a new process and issues an exec, the new 
process must issue a ¢ sync to build the private library data structure associated 
with a transport endpoint and to synchronize the data structure with the relevant 
provider information. 


It is important to remember that the transport provider treats all users of a 
transport endpoint as a single user. If muluple processes are using the same 
endpoint, they should coordinate their activities so as not to violate the state of 
the provider. ¢ sync returns the current state of the provider to the user, thereby 
enabling the user to verify the state before taking further action. This 
coordination is only valid among cooperating processes; it is possible that a 
process or an incoming event could change the provider’s state after a t_ sync is 
issued. 


If the provider is undergoing a state transition when ¢ sync is called, the 
function will fail. 


On failure, ¢_errno may be set to one of the following: 


([TBADF] The specified file descriptor is a valid open file 
descriptor but does not refer to a transport endpoint. 

(TSTATECHNG] The transport provider is undergoing a state change. 

[TSYSERR] A system error has occurred during execution of this 
function. 
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SEE ALSO 
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dup(2), exec(2), fork(2), open(2). 
CTIX Network Programmer's Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 


t sync returns the state of the transport provider on successful completion and 
-1 on failure and ¢ errno is set to indicate the error. The state returned can be 


one of the following: 
T_UNBND 

T_IDLE 

T_OUTCON 
T_INCON 
T_DATAXFER 
T_OUTREL 


T_INREL 


unbound 
idle 
outgoing connection pending 


incoming connection nending 


data transfer 

outgoing orderly release (waiting for an orderly release 
indication) 

incoming orderly release (waiting for an orderly release 
request) 
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NAME 
t_unbind - disable a transport endpoint 


SYNOPSIS 
#include <tiuser.h> 
int t_unbind(fd) 
int fd; 
DESCRIPTION 
The t_unbind function disables the transport endpoint specified by fd which was 
previously bound by t bind (3N). On completion of this call, no further data or 


events destined for this transport endpoint will be accepted by the transport 
provider. 


On failure, ¢_ errno may be set to one of the following: 


(TBADF] The specified file descriptor does not refer to a transport 
endpoint. 

[TOUTSTATE} The function was issued in the wrong sequence. 

[TLOOK} An asynchronous event has occurred on this transport 
endpoint. 

[TSYSERR] A system error has occurred during execution of this 
function. 

SEE ALSO 
t_bind(3N). 


CTIX Network Programmer’ s Primer. 
UNIX System V Release 3.2 Network Programmer's Guide. 


DIAGNOSTICS 
t_unbind returns 0 on success and -1 on failure and ¢ errno is set to indicate the 
error. 
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NAME 
tmpfile - create a temporary file 


SYNOPSIS 
#include <stdio.h> 


FILE *tmpfile () 


DESCRIPTION 
tmpfile creates a temporary file using a name generated by tmpnam(3S), and 
returns a corresponding FILE pointer. If the file cannot be opened, an error 
message is printed using perror(3C), and a NULL pointer is returned. The file 
will automatically be deleted when the process using it terminates. The file is 
opened for update (w+). 

SEE ALSO 


neaatl 


crcat(Z), wilink(Z), fopen(35), mkiemp(3C), perror(3C), stdio(3S), tmpnam(3S). 
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NAME 
tmpnam, tempnam - create a name for a temporary file 


SYNOPSIS 
#include <stdio.h> 


char *tmpnam (s) 
char +s; 


char *tempnam (dir, pfx) 
char *dir, *pfx; 


DESCRIPTION 
These functions generate file names that can safely be used for a temporary file. 


tmpnam always generates a file name using the path-prefix defined as 
P_tmpdir in the <stdio.h> header file. If s is NULL, 2mpnam leaves its result 
in an internal static area and returns a pointer to that area. The next call to 
tmpnam will destroy the contents of the area. If s is not NULL, it is assumed to 
be the address of an array of at least L_tmpnam bytes, where L_tmpnam is a 
constant defined in <stdio.h>; tmpnam places its result in that array and returns 
S. 


tempnam allows the user to control the choice of a directory. The argument dir 
points to the name of the directory in which the file is to be created. If dir is 
NULL or points to a string that is not a name for an appropriate directory, the 
path-prefix defined as P_tmpdir in the <stdio.h> header file is used. If that 
directory is not accessible, /tmp will be used as a last resort. This entire 
sequence can be up-staged by providing an environment variable, TMPDIR , in 
the user’s environment, whose value is the name of the desired temporary-file 
directory. 


Many applications prefer their temporary files to have certain favorite initial 
letter sequences in their names. Use the pfx argument for this. This argument 
may be NULL or point to a string of up to five characters to be used as the first 
few characters of the temporary-file name. 


tempnam uses malloc (3C) to get space for the constructed file name and returns 
a pointer to this area. Thus, any pointer value returned from tempnam may 
serve as an argument to free [see malloc(3C)]. If tempnam cannot return the 
expected result for any reason—that is, malloc(3C) failed—or none of the 
above mentioned attempts to find an appropriate directory was successful, a 
NULL pointer will be returned. to remove the file when its use is ended. 


SEE ALSO 
creat(2), unlink(2), fopen(3S), malloc(3C), mktemp(3C), tmpfile(3S). 
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CAVEATS 


NOTES 


If called more than 17,576 times in a single process, these functions will start 
recycling previously used names. 


Between the time a file name is created and the file is opened, it is possible for 
some other process to create a file with the same name. This can never happen 
if that other process is using these functions or mktemp, and the file names are 
chosen to render duplication by other means unlikely. 


These functions generate a different file name each time they are called. 


Files created using these functions and either fopen(3S) or creat(2) are 
temporary only in the sense that they reside in a directory intended for 
temporary use, and their names are unique. It is the user’s responsibility to use 
link (9\ 
J 
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NAME 


trig: sin, COS, tan, asin, acos, atan, atan2 - trigonometric functions 


SYNOPSIS 


#include <math.h> 


double sin (x) 
double x; 


double cos (x) 
double x; 


double tan (x) 
double x; 


double asin (x) 
double x; 


double acos (x) 
double x; 


double atan (x) 
double x; 


double atan2 (y, x) 
double y, x; 


DESCRIPTION 


Sin, cos and tan return respectively the sine, cosine and tangent of their 
argument, x, measured in radians. 


asin returns the arcsine of x, in the range (-1/2,7/2]. 
acos returns the arccosine of x, in the range [0,7]. 
atan retums the arctangent of x, in the range [-1/2,n/2]. 


atan2 returns the arctangent of y/x, in the range (-1,7], using the signs of both 
arguments to determine the quadrant of the return value. 


SEE ALSO 


matherr(3M). 


DIAGNOSTICS 


sin, cos, and tan lose accuracy when their argument is far from zero. For 
arguments sufficiently large, these functions return zero when there would 
otherwise be a complete loss of significance. In this case a message indicating 
TLOSS error is printed on the standard error output. For less extreme arguments 
Causing partial loss of significance, a PLOSS error is generated but no message 
is printed. In both cases, errno is set to ERANGE. 
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If the magnitude of the argument of asin or acos is greater than one, or if both 
arguments of atan2 are zero, zero is returned and errno is set to EDOM. In 
addition, a message indicating DOMAIN error is printed on the standard error 
output. 

These error-handling procedures can be changed with the function 
matherr (3M). 


SEE ALSO 
matherr(3M). 
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NAME 
tsearch, tfind, tdelete, twalk - manage binary search trees 


SYNOPSIS 
#include <search.h> 


char *tsearch ((char *) key, (char **) rootp, compar) 
int (*compar)( ); 


char *tfind ((char *) key, (char **) rootp, compar) 
int (*compar)( ); 


char *tdelete ((char *) key, (char **) rootp, compar) 
int (compar) ); 


void twalk ((char *) root, action) 
void (*action)( ); 


DESCRIPTION 
tsearch, tfind, tdelete, and twalk are routines for manipulating binary search 
trees. They are generalized from Knuth (6.2.2) Algorithms T and D. All 
comparisons are done with a user-supplied routine. This routine is called with 
two arguments, the pointers to the elements being compared. It returns an 
integer less than, equal to, or greater than 0, according to whether the first 
argument is to be considered less than, equal to, or greater than the second 
argument. The comparison function need not compare every byte, so arbitrary 
data can be contained in the elements in addition to the values being compared. 


tsearch is used to build and access the tree. key is a pointer to a datum to be 
accessed or stored. If there is a datum in the tree equal to *key (the value 
pointed to by key), a pointer to this found datum is returned. Otherwise, *key is 
inserted, and a pointer to it returned. Only pointers are copied, so the calling 
routine must store the data. rootp points to a variable that points to the root of 
the tree. A NULL value for the variable pointed to by rootp denotes an empty 
tree; in this case, the variable will be set to point to the datum which will be at 
the root of the new tree. 


Like tsearch, tfind will search for a datum in the tree, returning a pointer to it if 
found. However, if it is not found, ¢ind will return a NULL pointer. The 
arguments for tfind are the same as for tsearch. 


tdelete deletes a node from a binary search tree. The arguments are the same as 
for tsearch. The variable pointed to by rootp will be changed if the deleted 
node was the root of the tree. tdelete returns a pointer to the parent of the 
deleted node, or a NULL pointer if the node is not found. 
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twalk traverses a binary search tree. root is the root of the tree to be traversed. 
(Any node in a tree can be used as the root for a walk below that node.) action 
is the name of a routine to be invoked at each node. This routine is, in turn, 
called with three arguments. The first argument is the address of the node being 
visited. The second argument is a value from an enumeration data type typedef 
enum { preorder, postorder, endorder, leaf } VISIT; (defined in the <search.h> 
header file), depending on whether this 1s the first, second or third time that the 
node has been visited (during a depth-first, left-to-right traversal of the tree), or 
whether the node is a leaf. The third argument is the level of the node in the 
tree, with the root being level zero. 


The pointers to the key and the root of the tree should be of type pointer-to- 
element, and cast to type pointer-to-character. Similarly, although declared as 
type pointer-to-character, the value returned should be cast into type pointer- 


tr alamant 
Mas WViIVLLIVill. 


EXAMPLE 
The following code reads in strings and stores structures containing a pointer to 
each string and a count of its length. It then walks the tree, printing out the 
stored strings and their lengths in alphabetical order. 


#include <search.h> 
#include <stdio.h> 


struct node { /+ pointers to these are stored in the tree +/ 
char «string; 
Int length; 

}; 


char string _space[10000]; /* space to store strings */ 
struct node nodes[500]; /+ nodes to store +/ 
struct node +troot = NULL; /* this points to the root +/ 


main( ) 

{ 
char +strptr = string space; 
struct node «nodeptr = nodes; 
vold print_node{), twalk( ); 
int i = 0, node_compare( ); 


while (gets(strptr) f= NULL && i++ < 500) { 
/* set node */ 
nodeptr->string = strptr; 
nodeptr->length = strien(strptr); 
/* put node into the tree +/ 





TSEARCH(3C) TSEARCH(3C) 


NAME 
tsearch, tfind, tdelete, twalk - manage binary search trees 


SYNOPSIS 
#include <search.h> 


char *tsearch ((char *) key, (char **) rootp, compar) 
int (compar) ); 


char *tfind ((char *) key, (char **) rootp, compar) 
int (*compar)( ); 


char *tdelete ((char *) key, (char **) rootp, compar) 
int (*compar) ); 


void twalk ((char *) root, action) 
void (*action)( ); 


DESCRIPTION 
tsearch, tfind, tdelete, and twalk are routines for manipulating binary search 
trees. They are generalized from Knuth (6.2.2) Algorithms T and D. All 
comparisons are done with a user-supplied routine. This routine is called with 
two arguments, the pointers to the elements being compared. It returns an 
integer less than, equal to, or greater than 0, according to whether the first 
argument is to be considered less than, equal to, or greater than the second 
argument. The comparison function need not compare every byte, so arbitrary 
data can be contained in the elements in addition to the values being compared. 


tsearch is used to build and access the tree. key is a pointer to a datum to be 
accessed or stored. If there is a datum in the tree equal to *key (the value 
pointed to by key), a pointer to this found datum is returned. Otherwise, *key is 
inserted, and a pointer to it returned. Only pointers are copied, so the calling 
routine must store the data. rootp points to a variable that points to the root of 
the tree. A NULL value for the variable pointed to by rootp denotes an empty 
tree; in this case, the variable will be set to point to the datum which will be at 
the root of the new tree. 


Like tsearch, tfind will search for a datum in the tree, returning a pointer to it if 
found. However, if it is not found, ¢find will return a NULL pointer. The 
arguments for ¢find are the same as for tsearch. 


tdelete deletes a node from a binary search tree. The arguments are the same as 
for tsearch. The variable pointed to by rootp will be changed if the deleted 
node was the root of the tree. tdelete returns a pointer to the parent of the 
deleted node, or a NULL pointer if the node is not found. 
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twalk traverses a binary search tree. root is the root of the tree to be traversed. 
(Any node in a tree can be used as the root for a walk below that node.) action 
is the name of a routine to be invoked at each node. This routine is, in turn, 
called with three arguments. The first argument is the address of the node being 
visited. The second argument is a value from an enumeration data type typedef 
enum { preorder, postorder, endorder, leaf } VISIT; (defined in the <search.h> 
header file), depending on whether this is the first, second or third time that the 
node has been visited (during a depth-first, left-to-right traversal of the tree), or 
whether the node is a leaf. The third argument is the level of the node in the 
tree, with the root being level zero. 


The pointers to the key and the root of the tree should be of type pointer-to- 
element, and cast to type pointer-to-character. Similarly, although declared as 
type pointer-to-character, the value returned should be cast into type pointer- 
to-eiement. 
EXAMPLE 

The following code reads in strings and stores structures containing a pointer to 
each string and a count of its length. It then walks the tree, printing out the 
stored strings and their lengths in alphabetical order. 


#include <search.h> 
#include <stdio.h> 


struct node { /+ pointers to these are stored in the tree */ 
char string; 
Int length; 

}; 

char string space[10000]; /+ space to siore strings +/ 

struct node nodes[500]; /+ nodes to store */ 


struct node «root= NULL; /* this points to the root +/ 


main( ) 

{ 
char «strptr = string space; 
struct node *nodeptr = nodes; 
void print_node{ ), twalk( ); 
Int i = 0, node_compare({); 


while (gets(strptr) l= NULL && i++ < 500) { 
/+ set node */ 
nodeptr->string = strptr; 
nodeptr->length = strien(strptr); 
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/* put node into the tree +/ 
(void) tsearch((char «)nodeptr, 

(char **) &root, node_compare); 
/+ adjust pointers, don't overwrite tree +/ 
strptr += nodeptr->length + 1; 


nodeptr++; 
} 
twalk((char *)root, print_node); 
} 
/« This routine compares two nodes, based on an 
alphabetical ordering of the string field. +/ 
int 


node_compare(node1, node2) 
char *node1, «node2; 


{ 
return stremp(((struct node +)node1)->string, 
((struct node +) node2)->string); 
} 
/x This routine prints out a node, the first time 
twalk encounters it. +/ 
void 


<a print_node(node, order, level) 
char *+node; 

VISIT order; 

int level; 


{ 
if (order == preorder || order == leaf) { 
(void)printf("string = %20s, length = %di\n", 
(+((struct node **)node))->string, 
(+((struct node **)node))->length); 


} 


SEE ALSO 
bsearch(3C), hsearch(3C), Isearch(3C). 


DIAGNOSTICS 
A NULL pointer is returned by tsearch if there is not enough space available to 
create a new node. 


A NULL pointer is returned by #find and tdelete if rootp is NULL on entry. 


If the datum is found, both tsearch and éfind return a pointer to it. If not, ffind 
returns NULL, and tsearch returns a pointer to the inserted item. 


ae 
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CAVEAT 
If the calling function alters the pointer to the root, results are unpredictable. 


WARNINGS 
The root argument to twalk is one level of indirection less than the rootp 


arguments to tsearch and tdelete. 


There are two nomenclatures used to refer to the order in which tree nodes are 
visited. tsearch uses preorder, postorder, and endorder in respective order to 
refer to visting a node before any of its children, after its left child and before 
its right, and after both its children. The alternate nomenclature uses preorder, 
inorder, and postorder to refer to the same visits, which could result in some 
confusion over the meaning of postorder. 
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NAME 
ttyname, isatty - find name of a terminal 


SYNOPSIS 
char *ttyname (fildes) 
int fildes; 


int isatty (fildes) 
int fildes; 


DESCRIPTION 
ttyname returns a pointer to a string containing the null-terminated path name 
of the terminal device associated with file descriptor fildes. 


isatty returns 1 if fildes is associated with a terminal device, 0 otherwise. 


FILES 
/dev/* 


DIAGNOSTICS 
ttyname returns a NULL pointer if fildes does not describe a terminal device in 
directory /dev. 


CAVEAT 
The return value points to static data whose content is overwritten by each call. 
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NAME 
ttyslot - find the slot in the utmp file of the current user 


SYNOPSIS 
int ttyslot ( ) 


DESCRIPTION 
ttyslot returns the index of the current user’s entry in the /etc/utmp file. This is 
accomplished by actually scanning the file /etc/inittab for the name of the 
terminal associated with the standard input, the standard output, or the error 
output (0, 1, or 2). 

FILES 


/etcfnittab 
/etc/utmp 


getut(3C), ttyname(3C). 


DIAGNOSTICS 
A value of 0 is returned if an error was encountered while searching for the 
terminal name or if none of the above file descriptors is associated with a 
terminal device. 
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NAME 
ungetc - push character back into input stream 


SYNOPSIS 
#include <stdio.h> 


int ungetc (c, stream) 
int ¢; 
FILE *stream; 


DESCRIPTION 
ungetc inserts the character c into the buffer associated with an input stream. 
That character, c, will be returned by the next getc(3S) call on that stream. 
ungetc returns c and leaves the file stream unchanged. 


One character of pushback is guaranteed, provided something has already been 
read from the stream and the stream is actually buffered. 


If c equals EOF, ungetc does nothing to the buffer and returns EOF. 
fseek (3S) erases all memory of inserted characters. 


SEE ALSO 
fseek(3S), getc(3S), setbuf(3S), stdio(3S). 


DIAGNOSTICS 
ungetc returns EOF if it cannot insert the character. 


BUGS 
When stream is stdin, one character may be pushed back onto the buffer 
without a previous read statement. 
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NAME 
vprintf, vfprintf, vsprintf - print formatted output of a varargs argument list 


SYNOPSIS 
#include <stdio.h> 
#include <varargs.h> 


int vprintf (format, ap) 
char *format; 
va_list ap; 


int vfprintf (stream, format, ap) 
FILE *stream; 

char *format; 

va_list ap; 

iat vsprinif (s, format, ap) 

char *s, *format; 

va_list ap; 


DESCRIPTION 
vprintf, vfprinif, and vsprintf are the same as printf, fprintf, and sprinif 
respectively, except that instead of being called with a variable number of 
arguments, they are called with an argument list as defined by varargs(S5). 


EXAMPLE 
The following demonstrates the use of vfprinif to write an error routine. 


#include <stdio.h> 
#include <varargs.h> 


/* 

* error should be called like 

*  error(function_name, format, arg1, arg2...); */ 
/*VARARGS+«/ 
void 
error(va_alist) 
/+ Note that the function_name and format arguments */ 
/* cannot be separately declared because of the +/ 
{+ definition of varargs. */ 

va_del 

{ 


va_list args; 
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char +fmt; 


va_start(args); 

/* print out name of function causing error +/ 

(vold)fprintf(stderr, "ERROR in %s: ", va_arg{args, 
char *)); 

fmt = va_arg(args, char *); 

/* print out remainder of message */ 

(void)viprinti(stderr, fmt, args); 

va_end(args); 

(void)abort{ ); 


SEE ALSO 
printf(3S), varargs(5). 


